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Preface 



This manual contains RT-11 system reference data excerpted from the docset. See 
Associated Documents. 



Intended Audience 

This information is provided for use by advanced RT-11 users, including FORTRAN 
IV, FORTRAN-77, and MACRO-11 assembly language programmers and C language 
programmers. 
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Conventions 

The following conventions are used in this manual. 



Convention 



Meaning 



Braces ({ }) 



Brackets ([ ]) 



/option 1 
/option2 



Bold 

options 

lowercase 
characters 



UPPERCASE 
characters 



I RETURN I 



I CTRL/X I 



In command syntax examples, braces enclose options that 
are mutually exclusive. You can choose only one option 
from the group of options that appears in braces. 

Square brackets in a format line represent optional 
parameters, qualifiers, or values. 

Square brackets in an option summary surrounding two 
or more options mean that you can specify any one of the 
enclosed options or any combination of them. The following 
example means you can specify either the /BEFORE or the 
/SINCE option or a combination of both to express one or 
two ranges of dates: 

/BEFORE [:date] 
/SINCE[:date] 

Bold options in an option summary indicate default 
options; that is, the option that RT-11 uses if you do not 
specify any choice of action. 

In command syntax examples, lowercase characters 
represent elements of a command for which you supply a 
value. For example: 

DELETE fllespec 

In command syntax examples, uppercase characters 
represent elements of a command that should be entered 
exactly as given. 

[ret] in examples represents the RETURN key. Unless the 
manual indicates otherwise, terminate all commands or 
command strings by pressing [ret]. 

I RETURN I in the text represents the RETURN key. 

I cTRL/x I indicates a control-key sequence. While pressing 
CTRL key, press another key. For example: | ctrl/c | 
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Chapter 1 

KED/KEX Keypad Editor 



KED is the keypad editor for an unmapped monitor; KEX is the same editor 
adapted to a mapped monitor. 



Major KED/KEX Commands 

EDIT/CREATE file 
EDIT/INSPECT file 

EXIT flNTERl 



I GOLD I I COMMAND 



GOLD COMMAND 



I GOLD 1 1 command" 



GOLD command 



GOLD COMMAND 



I GOLD 1 1 command" 



QUIT [ENTER] 



set 132 I ENTER I 



set 80 I ENTER I 



SET WRAP [number] [enter] 
SET SECTION number [enter] 



I GOLD 1 1 COMMAND | SET PAGE number [enter] 



Create a file 
Inspect only file 
Save the edited file 
Delete the edited file 



Set screen to display 130 
characters on a line. 

Set screen to display 78 characters 
on a line. 



Set the right margin 

Set the number of lines for a 
section 

Set the number of lines for a page 



I GOLD I number [gold] i specins i 



Enter the ASCII equivalent 
(number) of characters 



GOLD bottom 



I GOLD I [TOP I 



Move cursor to end of file 
Move cursor to beginning of file 



I GOLD I jFiNDj character-string | advance | or j backup | 



Find text 
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Major KED/KEX Commands 



[GOLD] I COMMAND | SET SEARCH EXACT [enter] 



Distinguish between upper and 
lowercase letters 
[GOLD] I COMMAND | SET SEARCH GENERAL | enter | Not distinguish between upper 

and lowercase letters 



[GOLD] I COMMAND | SET BOUNDED I ENTER I 

[GOLD] I COMMAND | SET UNBOUNDED | enter | 



Limit a search to a page 
Extend a search to end of file 



[ I GOLD I ] I DELCHAR I 



[ I GOLD I ] I DELWORD] 
[ I GOLD I ] jPELLINEj 



[Unjdelete a character 
[Un] delete a word 
[Un] delete a line 



I SELECT I move cursor ]cuT] 



I GOLD I I PASTE I 

[GOLD] I COMMAND | CLEAR PASTE | enter | 



Place text in buffer 
Restore text from buffer 
Clear buffer 



I GOLD 1 1 COMMAND | OUTPUT filespec | enter | 

I GOLD 1 1 command"] close [enter] 

[GOLD] 1 COMMAND ] WRITE SELECT [enter] 

[GOLD] ] COMMAND ] WRITE REST [enter] 



[gold] I COMMAND I WRITE number [enter] 



Open a file for output 

Close a file 

Enter text into a file opened for 
output 

Write rest of text into a file opened 
for output 

Write number of lines into a file 
opened for output 



[GOLD] I COMMAND | OPEN INPUT filespec [enter] 
[GOLD] I COMMAND | INCLUDE rest [enter] 

[GOLD] 1 COMMAND | INCLUDE number [enter] 



Open an input file 

Include rest of input file in edited 
file 

Include number of lines from input 
file in edited file 



LEARN [identifier] 

[GOLD] S 



Begin the definition of a macro 
End the definition of a macro 



1-2 KED/KEX Keypad Editor 



Major KED/KEX Commands 

I GOLD I M identifier Execute the macro specified 

by identifier 

SAVE identifier [filespec] Copy macro to auxiliary file 

LOAD identifier [filespec] Copy auxiliary file to macro buffer 

©filespec Execute a macro directly from 

specified file 
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Chapter 2 

SL Command-Line Editor 



Major Command-Line Commands 

General Editing Functions 



Command or Key 



Function 



I CTRL/A I 

RECALL/ALL 

RECALL command or 

RECALL number-in-command-stack 

Arrow Keys 



Switches between INSERT and REPLACE 
modes. 

Recalls all previously issued commands. 

Recalls a previous command. 

Move the cursor through the command 
stack or across the command line in the 
direction of the arrows. 



Delete Functions 



Key 



Function 



Eg 



CTRL7U 



Keypad Comma Key □ 
Keypad Hyphen Key □ 



I LINE feed] or I CTRL/J | 

DELETE Key |<xJ| 



Deletes the command line from the cursor 
position to the end of the command line. 

Deletes the command line from the cursor 
position to the beginning of the command line. 

Deletes one character at the cursor position. 

Deletes one element of command syntax at the 
cursor position. 

Deletes the element of command syntax to the 
left of the cursor. 

Deletes the character to the left of the cursor. 
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Major Command-Line Commands 



Restore Functions 



Key 


Function 


|PFi| together with the keypad 
key you pressed to delete 
information 


Restores a command or command element that 
you deleted with a keypad function. 


Movement Functions 


Key 


Function 



[pfT| together with [^ 

[pfT| together with g 
or Keypad [2] 
Keypad |T| 
Keypad [3] 
Keypad [±\ 

Keypad [5] 



Switches the character at the cursor position 
with the character to the right of the cursor, also 
moving the cursor to the right. 

Moves the cursor to the beginning of the 
command line. 

Moves the cursor to the end of the preceding 
command line. 

Moves the cursor across one element of syntax. 

Moves the cursor one character position. 

Causes subsequent cursor movement to be 
forward. 

Causes subsequent cursor movement to be 
backward. 



Display Functions 



Key 



Function 



I CTRL/E I or ^ 



CTRL/R or CTRLM 



Displays the previous command. 
Redisplays the current command line. 
Displays a help listing of SL commands. 



Enable full SL (command-line) editor power with: SET SL KMON,KED,RECALL,ON 
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Chapter 3 

RT-11 Commands 



This chapter alphabetically lists RT-11 keyboard monitor commands, most of which 
are DCL commands. 

Most command descriptions contain the following elements: 

Type of Command 

In parentheses underneath the command is the name of the RT-11 system 
component that executes that command. This is either KMON alone, a utility 
program(s), or a device handler. 

Definition 

A few sentences identifying the command. 

Format 

The syntax for using the command. 

Option Summary 

A listing of all the command's options, if it takes options. 

Option Descriptions 

An explanation of how to use each option with some examples. 



ABORT 

(KMON) 

Terminates, from the system terminal, foreground and system jobs with attached 
private terminals. 



ABORT jobname 
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ASSIGN 

(KMON) 

Defines a logical name equivalent for a physical device. 

ASSIGN device-name: logical-device-name: 

where: 

device-name specifies either a physical-device or a logical-device 

name. 

logical-device-name specifies either a logical-device name or the 

catch-all device assignment. 

B (Base) 

(KMON) 

Sets a relocation base for subsequent Examine or Deposit commands. 

B [address] 

BACKUP 

(BUP) 

• Copies (backs up) and restores RT-11 files or volumes into saveset or logical-disk 
files. 

• Initializes backup volumes when needed. 

• Verifies backed-up and restored data. 

• Lists directories of backup volumes and logical disks. 

BACKUP in-spec out-spec 
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BACKUP 



Command Options 



In-Spec Options 



/DEVICE 
/DIRECTORY 

/FILE 

/INITIALIZE 

/[NO]LOG 

/[NOIQUERY 

/RESTORE 

/[NOIREWIND 

/[NOISCAN 

/SYSTEM 

/VERIFY 



f /OUTPUT:filespec 1 
I /PRINTER J 



[ssname]/SAVESET[,filename,...] 
[ldname]/SUBSET[,filename,...] 



Table 3-1: Valid BACKUP Option Combinations 



Operation 



Options 



BACKUP to a saveset 



BACKUP to a subset 



DIRECTORY 



RESTORE from a saveset 



/[NOISCAN 

/DEVICE 

/[NOIREWIND 

/VERIFY 

/[NOILOG 

/[NOIQUERY 

/INITIALIZE 

/SUBSET 
/VERIFY 

/DIRECTORY 

/DIRECTORY/OUTPUT[:filespec] 

/DIRECTORY/PRINTER 

/SUBSET 

/SAVESET 

/RESTORE 

/SYSTEM 

/FILE 

/DEVICE 

/[NOIREWIND 

/SAVESET 

/VERIFY 

/[NOILOG 
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BACKUP 

Table 3-1 (Cont.): Valid BACKUP Option Combinations 



Operation Options 



RESTORE from a subset /SUBSET 

/RESTORE 
/SYSTEM 
/VERIFY 
/[NOILOG 

VERIFY (only) /RESTORE/VERIFYONLY 



/DEVICE 

Backs up or restores (with the /RESTORE option) an entire volume in image mode. 
You can back up volumes to one or more disks, diskettes, or magtapes. 

/DIRECTORY 

Lists savesets on a backup volume or on a series of backup volumes. 

.BACKUP/DIRECTORY DUl : 

Lists files in a saveset. 

. BACKUP/DIRECTORY DUl : TEMP . BUP/SAVESET 

Lists files within a logical-disk file. 

. BACKUP/DIRECTORY DUO : MYBACK . DSK/ SUBSET 

/FILE 

Used only with the /RESTORE option. Restores an entire saveset to one file. 

.BACKUP /FILE /RESTORE /VERIFY MS -.FIRST .TXT DLl : 

/INITIALIZE 

Initializes a volume for use as an output volume in a backup operation. 

Use this option if your backup volume is an uninitialized backup volume or if you 
want to reinitialize a previously used backup volume. 

.BACKUP/INITIALIZE DL0:F*.FOR DU1:WRK 

/[NOJLOG 

[Does not] display a list of all the files affected by a BACKUP command operation 
as the operation progresses. 
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BACKUP 

/OUTPUT:filespec 

(used only with the /DIRECTORY option) Stores a backup or logical-disk volume 
directory in a file. 

. BACKUP /DIRECTORY/OUTPUT -.DUO -.MYBACK.DIR DUl -.MYBACK. SUP /SAVE SET 

/PRINTER 

(used only with the /DIRECTORY option) Prints directory listings of backup or 
logical-disk volumes. 

. BACKUP /DIRECTORY/PRINTER MUO : 

/[NOJQUERY 

[Does not] prompt you for the various responses required from the terminal. 

/RESTORE 

Restores backed-up data to a standard RT-11 formatted disk. You can restore: 

• Complete savesets as a file or as a device 

.BACKUP/RESTORE/VERIFY MUO : 28MAY .BUP/SAVESET DLl : 
.BACKUP /RESTORE DU: DUl: 

• Selected files from a saveset 

.BACKUP/RESTORE/VERIFY MSO : 28MAY. BUP/SAVESET, FOO. OBJ DLl: 

• Selected files from a logical-disk file 

.BACKUP/RESTORE/VERIFY DLl : FRIDAY .DSK/ SUBSET, MEMOl .TXT DLO : 

• File-image backups not contained in a saveset or subset (see the /FILE option) 

/[NOJREWIND 

[Does not] rewind a magtape before performing the next operation. 

/SAVESET 

(used in combination with either the /RESTORE or /DIRECTORY options) Specifies 
the saveset containing a file(s) you want to restore or the saveset from which you 
want to obtain directories. 

.BACKUP /RESTORE/VERIFY MSO : 28MAY .BUP/SAVESET DLl: 

/[NOJSCAN 

[Does not] scan each output disk for bad blocks during the backup initialization 
procedure. 
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BACKUP 

/SUBSET 

(specified with the input file specification) Allows you to: 

• Create logical-disk images of the files you want to back up 

.BACKUP /VERIFY DUO :* .OBJ/ SUBSET DUl:OBJ 

• List directories of logical disks 

. BACKUP /DIRECTORY DUO :MYBACK.DSK/ SUBSET 

• Restore/extract one or more files from a logical-disk file 
BACKUP/RESTORE in-dev:ldname.dsk/SUBSET,file1 [,file2,...] out-dev: 

.BACKUP /RESTORE SY :WRK.DSK/ SUBSET, REPORT . * DK: 

/SYSTEM 

(used only with /RESTORE) Restores SYS files when using wildcards. 

A/ERIFY[:ONLY] 

Verifies that output data matches input data in a BACKUP/RESTORE operation. 

• A'^ERIFY verifies a data transfer as you are backing up the data. 

.BACKUP /VERIFY DUO : LGFIL.DAT DUl : 

• /RESTOREA/'ERIFY verifies a data transfer as you are restoring the data. 

• /RESTOREA^ERIFYONLY verifies a data transfer after you back up the data 
but before you change or delete the original data. 
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BOOT 

(DUP) 

Loads and starts a new monitor. 

BOOT input-spec 

where: 

input-spec specifies the device or monitor file to be bootstrapped. 

Command Options 

/FOREIGN 
AVAIT 



Boot-Block Bootstrap 

.BOOT SY: [RET] 
RT-llXM V05.6 

l\/lonitor-File Bootstrap 

.BOOT RTllXM [RET] 

/FOREIGN 

Boots a pre-RT-11 V4 volume or a non-RT-11 operating system. 

/WAIT 

Initiates the BOOT procedure but then pauses and waits for you to mount the 
volume you want to bootstrap. 
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CLOSE 

(KMON) 

Closes and makes permanent all output files that are currently open in the 
background job. 

CLOSE 

The CLOSE command is particularly useful in two cases: 

• After you type a | ctrl/c | to abort a background job 

• After an unexpected program termination 

In these cases, CLOSE preserves any new files that were being used by the 
terminated program. 

The CLOSE command has no effect on a foreground job and will not make 
permanent any files opened on magnetic tape. 

.R PROG [ret] 



CTRL/C I I CTRL7C | 
.CLOSE [RET] 



COMPILE 

(DIBOL, FORTRA, F-77, F77XM, MACRO, and CREF) 

Invokes the appropriate language processor to compile the files you specify. 

COMPILE filespec[s] 

Command Options Filespec Options 

/LIST[:filespec] /LIBRARY 

/ALLOCATE:size 

/[NO]OBJECT[:filespec] 
/ALLOCATE:size 
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COMPILE 



Command Options 



Filespec Options 



/DIBOL 

/ALPHABETIZE 
/CROSSREFERENCE 
/[NOILINENUMBERS 
/LOG 

/ONDEBUG 
/PAGE:length 
/TABLES 
L /[NOIWARNINGS 

/FORTRAN 

r /CHECK 
/CODE:type 

/CONTINUATIONS:value 
/DIAGNOSE 
/EXTEND 
fF4 or /F77 
/HEADER 
/I4 

/[NOILINENUMBERS 
/ONDEBUG 
/[NOIOPTIMIZE 
/RECORD:length 
/SHOW[:type] 
/STATISTICS 
/[NOISWAP 
/TRACE :type 
/UNITS:value 
/[NOIVECTORS 
/[NOIWARNINGS 
/WIDE 
/WORKFILE:value 

/MACRO 

/CROSSREFERENCE[:type[:type...]] 
/DISABLE:type[:type...] 
/ENABLE:type[:type...] 
/[NO]SHOW:type[:type...] 
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COMPILE 

/ALLOCATE :size 

(used with /LIST or /OBJECT) Reserves space on the device for the output file. A 
size of -1 reserves the largest possible space. 

/ALPHABETIZE 

Alphabetizes the entries in the symbol table listing. 

/CHECK 

(FORTRAN-77 only) Checks array references to ensure they are within the specified 
array address boundaries. 

/CODE:type 

(/FORTRAN IV only) Produces object code that is designed for a particular hardware 
configuration. Valid types are: EAE, EIS, FIS, and THR. 

/CONTINUATIONS:value 

(FORTRAN-77 only) Specifies the maximum decimal number of continuation lines 
in the program. The range for value is through 99; the default is 19. 

/CROSSREFERENCE[:type[:type...]] 

(DIBOL or MACRO) Generates a cross reference listing of symbols; type can be: 

C (Control section names) M (Macro names) 
E (Error codes) P (Permanent symbols) 

R (Register symbols) S (User-defined symbols) 

no argument — equivalent to :E:M:S 

/DIAGNOSE 

(FORTRAN IV only) Expands the crash dump information to include internal 
compiler tables and buffers. 

/DIBOL 

Invokes the DIBOL language processor to compile the associated files. 

/DISABLE:type[:type...] 

(MACRO only) Specifies .DSABL directives; type can be: 

ABS Generates absolute binary output. 

AMA Assembles absolute addresses as relative addresses. 

CDR Treats source columns beyond 72 as a comment. 

DBG Outputs internal symbol directory (ISD) records. 

FPT Truncates floating point. 
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COMPILE 

GBL Assumes undefined symbols are globals. 

LC Accepts lowercase characters in source programs. 

LSB Defines local symbol block. 

MCL Enables or disables automatic .MCALL. 

PNC Enables or disables binary output. 

REG Defines default register mnemonics. 

/ENABLE:type[:type...] 

(MACRO only) Specifies .ENABL directives; types are listed under /DISABLE. 

/EXTEND 

(FORTRAN IV or FORTRAN-77) With FORTRAN IV, extends the right margin 
from column 72 to column 80. With FORTRAN-77, extends the right margin of 
input lines from 72 to 132 columns. 

/F4 

Overrides any SET FORTRA conditional and calls the FORTRAN IV compiler (the 
default). 

/F77 

Overrides any SET FORTRA conditional and calls the appropriate FORTRAN-77 
compiler. 

/FORTRAN 

Invokes the FORTRAN language processor to compile the associated files. 

The FORTRAN-77 compiler under a mapped monitor is F77XM.SAV and under an 
unmapped monitor is F77.SAV. The FORTRAN IV compiler is FORTRA.SAV 

/HEADER 

(FORTRAN IV only) Includes a list of the current options in the printout. 

/I4 

(FORTRAN IV or FORTRAN-77) Allocates 2-word integers. 

/LIBRARY 

(MACRO only) Identifies any macro library files. 

/[NOJLINENUMBERS 

(DIBOL or FORTRAN) [Does not] include internal sequence numbers in the 
executable program. 
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/LIST[:filespec] 

Outputs a compiler or assembly listing to the line printer or to the filespec. (This is 
not the default) 

/LOG 

(DIBOL only) Creates a log of error messages generated by the compiler. 

/MACRO 

Invokes the MACRO assembler to assemble the associated files. 

/[NO]OBJECT[:filespec] 

[Does not] generate an OBJ file; default file name is the input file name. 

/ONDEBUG 

(DIBOL or FORTRAN) Includes symbol names in the DIBOL OBJ file; includes 
debug lines in the FORTRAN compilation. 

/[NOJOPTIMIZE 

(FORTRAN-77 only) [Does not] enable compiler optimization. 

/PAGE.Iength 

(DIBOL only) Defines the listing page size where length specifies the number of 
lines. 

/RECORD-.length 

(FORTRAN IV or FORTRAN-77) Overrides the default record length for 
sequentially formatted input and output. The meaningful range for length is from 
4 to 4095. 

/[NO]SHOW[:type] 

(FORTRAN IV, FORTRAN-77, or MACRO) Used with /FORTRAN, controls 
FORTRAN listing format. 

FORTRAN IV Listing Options 

Diagnostics only 

1 or SRC Source program and diagnostics 

2 or MAP Storage map and diagnostics 

3 Diagnostics, source program, and storage map 

4 or COD Generated code and diagnostics 
7 or ALL All of the above 
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COMPILE 



FORTRAN-77 Listing Options 



Minimal listing; diagnostics and program section summary 
only 

1 Source listing and program section summary 

2 Source listing, program section summary, and storage map 
(the default) 

3 Source listing, assembly code, program section summary, and 
section map 



Used with /MACRO, to specify MACRO .LIST directives; types are as follows. 



Type 



Default 



Controls 



BEX 


List 


BIN 


List 


CND 


List 


COM 


List 


LD 


Nohst 


LOC 


List 


MC 


List 


MD 


List 


ME 


Nolist 


MEB 


Nolist 


SEQ 


List 


SRC 


List 


SYM 


List 


TOC 


List 


TTM 


Line printer 



Extended binary code 

Generated binary code 

Unsatisfied conditionals, .IF and .ENDC 
statements 

Comments 

Listing directives with no arguments 

Location counter 

Macro calls, repeat range expansions 

Macro definitions, repeat range expansions 

Macro expansions 

Macro expansion binary code 

Source line sequence numbers 

Source code 

Symbol table 

Table of contents 

Wide or narrow listing format 



/STATISTICS 

(FORTRAN rV or FORTRAN-77) Includes compilation statistics in the listing, such 
as amount of memory used, amount of time elapsed, and length of the symbol table. 



RT-11 Commands 3-13 



/[NOJSWAP 

(FORTRAN IV or FORTRAN-77) [Does not] permit the USR to swap over the 
FORTRAN program in memory. 

/TABLES 

(DIBOL only) Generates a symbol table and label table as part of the listing. 

/TRACE:type 

(FORTRAN-77 only) Enables the FORTRAN-77 /S:xxx option that controls the 
generation of code used by the OTS during error traceback. 

/UNITS:value 

(FORTRAN IV or FORTRAN-77) Overrides the default number of logical units (6) 
to be open at one time. With FORTRAN IV, the maximum number you can specify 
is I610; with FORTRAN-77, the maximum is 99io. 

/[NOJVECTORS 

(FORTRAN IV only) [Does not] direct the FORTRAN compiler to use tables to 
access multidimensional arrays. 

/[NO]WARNINGS 

(DIBOL, FORTRAN IV, or FORTRAN-77) [Does not] include warning messages in 
compiler diagnostic error messages. 

/WIDE 

(FORTRAN-77 only) Produces a 132-column compiler listing. 

/WORKFILE lvalue 

(FORTRAN-77 only) Sets the workfile size. The default is 128io blocks. By default, 
value is octal; include a decimal point after value to specify a decimal radix. 



COPY 

(PIP, DUP, and FILEX) 
Transfers: 

• One file to another file 

• A number of files to a single file by concatenation 

• Files from a large volume to several smaller volumes 

• The bootstrap code on a volume to the boot blocks of that volume 

• The contents of a volume to a file and vice versa 
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• The contents of a device to another device 
COPY input-file[s] output-file 



COPY 



COPY Device Operations 



Command Options 



Input-File Options 



Output-File Options 



/BOOT[:dev] 
AVAIT 



/DEVICE 

/IMAGE 

/VERIFY 



/FILES 
AVAIT 



/END rvalue 
/START:value 



/ALLOCATEisize 
/START:value 



COPY Interchange Operations 



Command Options 



Input-File Options 



Output-File Options 



f /ASCII 1 
I /IMAGE J 



/ASCII 
/IMAGE 

/PACKED 

/QUERY 

/WAIT 



/DOS 

/OWNER:[nnn,nnn] 
/INTERCHANGE 
/TOPS 



/DOS 
/INTERCHANGE[:siz 



.} 
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COPY 



COPY File Operations 



Command Options 



Input-File Options 



Output-File Options 



/ASCII ] 
/BINARY > 
/IMAGE J 

/BEFORE[:date] 
/SINCE[:date] 

/DATE[:date] 

/NEWFILES 
/CONCATENATE 
/DELETE 
/EXCLUDE 
/IGNORE 
/INFORMATION 
/[NOILOG 
/MULTIVOLUME 
/PREDELETE 
/[NOJPROTECTION 
/[NOJQUERY 
/[NOJREPLACE 
/SETDATE[:date] 
/SLOWLY 
/SYSTEM 
/VERIFY 
/WAIT 



/POSITIONivalue 



/POSITION:value 



Using Wildcards 

You can use wildcards in the input or output file specification of the command. 
However: 

• The output file specification cannot contain embedded wildcards. 

• For all operations except CONCATENATE, if you use a wildcard in the input 
file specification, the corresponding output file name or file type must be an 
asterisk (*). 
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COPY 

Specifying a Date in a COPY Option 

The syntax for specifying the date is: 

[dd][:mmm][:yy] 

where: 

dd specifies the day (a decimal integer in the range 1-31). 

mmm specifies the first three characters of the name of the month. 

yy specifies the year (a decimal integer in the range 73-99). 

/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/ASCII 

Copies files in ASCII mode. 

/BEFORE[:date] 

Copies all files on a device created before the specified date. 

.COPY/BEFORE: 4 -.FEB -.90 * .MAC DUO:*. MAC 

/BINARY 

Copies formatted binary files, such as OBJ files produced by the assembler. 

. COPY/BINARY ANALYZ . OBJ DUl :*.* 

/BOOT[:dev] 

Copies bootstrap information from monitor and handler files to blocks and 2 
through 5 of a random-access volume, permitting you to use that volume as a 
system volume. 

.COPY/BOOT DUl : RTllFB . SYS DUl: 

/CONCATENATE 

Combines several input files into a single output file. 

. COPY /CONCATENATE DUl : * . FOR DUO : MERGE . FOR 

/DATE[:date] 

Copies only those files with the specified creation date. 

. COPY/DATE :20: FEB : 90 DUO : * . MAC DUl :*.* 
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/DELETE 

Deletes the input file after it has been copied. 

.COPY/DELETE JSPROG.SAV DUl : JSPROG . SAV 

/DEVICE 

Copies block for block the image of one device to another, and copies all the data 
from one disk to another without changing the file structure or the location of the 
files on the device. 

.COPY/DEVICE DUO: DUl: 

/DOS 

Transfers files between RSTS/E or DOS-11 format and RT-11 format. 

. COPY RK: PROG. BAS /DOS /OWNER : [200, 200] SY : * . * 

/END-.value 

Specifies the last block of the volume you are copying. 

.COPY/DEVICE/FILES DUO : /START: 0/END : 500 DUl : ADAM. MAC/START : 501 

/EXCLUDE 

Copies all the files on a device except the ones you specify. 

. COPY/EXCLUDE DUO : (*. OBJ, * . SAV) DUl :*.* 

/FILES 

Copies a volume (disk image) to a file on another volume or vice versa. The 
following command copies the file MYWORK.BAK to DUl: 

.COPY/DEVICE/FILES MYWORK.BAK DUl: 

/IGNORE 

Ignores input errors during a COPY operation. 

/IMAGE 

Copies entire blocks. 

/INFORMATION 

Displays informational rather than fatal messages for input files not found and 
copies all others. The following command copies input files FILE1.TXT and 
FILE3.TXT to DUl. However, since RT-11 is unable to find DU0:FILE2.TXT, RT-11 
displays a message to inform you that. 

. COPY/INFORMATION DUO : (FILEl , FILE2, FILE3) . TXT DUl :*.* 
?PIP-I-File not found DUO :FILE2 .TXT 
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/INTERCHANGE[:size] 

Transfers data in interchange format between interchange diskettes that are 
compatible with IBM 3741 format and RT-11 block-replaceable devices or the 
terminal. Size specifies the output record size; the default is 80 characters. 

. COPY PROG . MAC DXl : * . */ INTERCHANGE : 128 

/[NOJLOG 

[Does not] list on the terminal the names of the copied files. 

.COPY/LOG DUl: FILE. MAC DUO: FILE. MAC 
Files copied: 
DU1:FILE.MAC to DUO:FILE.MAC 

/MULTIVOLUME 

Copies files from an input volume to one or more output volumes. The following 
example shows all files on DUO being copied to several diskettes: 

. COPY/MULTIVOLUME DUO: *. * DUl : 
(Log of files copied) 

Mount next output volume in DUl:; Continue? Y 
(Log of files copied) 
Mount next output volume in DUl:; Continue? Y 

/NEWFILES 

Copies only those files that have the current system date. 

. COPY /NEWFILES * . * DUl :* .* 
Files copied: 
DK:A.FOR to DUl :A. FOR 
DK:B.FOR to DUl :B. FOR 
DK:C.FOR to DUl :C. FOR 

/OWNER:[nnn,nnn] 

Specifies the DOS-11 user identification code (UIC) for a DOS-11 input device. 

/PACKED 

Copies files in DECsystem-10, DOS, or interchange mode. 

/POSITION lvalue 

Positions the magtape so that you can copy at the point you specify. The values 
can be (tape rewinds and is searched or copied from), a positive integer (a search 
or copy is started at the specified point), or -1 (a search or copy is started at the 
current position). 
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/PREDELETE 

Deletes files on the output device having the same names and types as those you 
copy to that device, before copying the input files. 

/[NOJPROTECTION 

[Does not] give an output file protected status so that it cannot be deleted. 

/[NOJQUERY 

[Does not] ask for confirmation before copying each file. The following example 
copies three of the four MAC files stored on DK to DUl: 

. COPY/QUERY DK:*. MAC DUl :*.* 
Files copied: 
DK:A.MAC to DUl :A. MAC ? Y 

DK:B.MAC to DUl :B. MAC ? Y 

DK:C.MAC to DUl :C. MAC ? N 

DK : DEMOFl . MAC to DUl :DEM0F1 .MAC? Y 

/[NOJREPLACE 

[Does not] replace a file on the output device with the same name as the file you 
specify for output. 

/SETDATE[:date] 

Assigns the specified date to all the files copied. 

/SINCE:[date] 

Copies all files on a specified device that were created on or after a specified date. 
The following command copies only those MAC files on DK created on or after 
February 24, 1991: 

.COPY/SINCE:24:FEB:91 * .MAC DUO:*. MAC 
Files copied: 
DK:A.MAC to DUO:A.MAC 
DK: B.MAC to DUO: B.MAC 
DK:C.MAC to DUO:C.MAC 

/SLOWLY 

Transfers files one block at a time. 

/START[:value] 

Specifies the last block of the disk you are copying. The following command copies 
blocks 500 to 550 of DUO to DUl, starting at block 100: 

. COPY/DEVICE DUO : /START: 500/END : 550 DUl : /START: 1 00 
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/SYSTEM 

Includes system (SYS) files when you use wildcards in an input file type, or you use 
the /EXCLUDE option. 

COPY *.SYS DUl:* 

/TOPS 

Specifies DECsystem-10 DECtape input. 

/VERIFY 

Verifies that the output matches the input after a copy operation. 

/WAIT 

Waits for the specified volume to be mounted before executing the command. 
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CREATE 

(DUP) 

Creates or extends a file entry in a volume's directory. 

CREATE filespec 



Filespec Options 



/EXTENSION 
/START:value 
/ALLOCATE:size 



/ALLOCATE :size 

Reserves the number of blocks you specify for the file you are creating; size 
represents a decimal number of blocks. A value of -1 indicates a file of the 
maximum size available on the volume. 

. CREATE DUl :myf±le . type/ START : 11 7 /ALLOCATE : 28 

/EXTENSION -.value 

Extends an existing file by the number of blocks you specify; value is a decimal 
number of blocks. At least value free blocks must follow the file. 

Procedure for Extending a File 

1. With the DIRECTORY/FULL command, determine whether there is available 
space adjacent to the file you want to extend: 

.DIRECTORY/FULL file-to-extend 

2. With the CREATE command, extend your file: 
. CREATE DUl : my file . type /EXTENSION : number 

/START.value 

Specifies the starting block number of the file you are creating. The value argument 
specifies a decimal block number. To restore a deleted file not yet overwritten, first 
with the DIRECTORY/DELETED command, estabhsh the starting block numbers 
of the delete file: 

. DIRECTORY /DELETED DUl : 



3-22 RT-11 Commands 



D (Deposit) 

(KMON) 

Deposits octal values in memory, beginning at the location you specify. 

D address= [ value[,.. .value] ] 

The D (deposit) command accepts both word and byte addresses, but it always 
executes the command as though you specified a word address. (If you specify an 
odd address, the system decreases it by one to make it even.) The D command 
stores all values as word quantities. In this example, the D command deposits 
zeroes into locations 300, 302, 304, and 306: 

.D 300=, , , 

DATE 

(KMON) 

Sets or displays the current system date. 

DATE [dd-mmm-yy]) 

where: 

dd represents the day (a decimal number from 1 to 31). 

mmm represents the first three characters of the name of the month. 

yy represents the year (a decimal number from 73 to 99). 

The following example enters the current date: 

.DATE 18-MAY-91 

The next example displays the current system date: 

.DATE 
18-May-91 
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DEASSIGN 

(KMON) 

Removes logical name assignments made with ASSIGN. DEASSIGN with no 
argument removes all assignments that are currently in effect. 

DEASSIGN [logical-device-name] 

For example: 

.DEASSIGN INP: 

DELETE 

(PIP, FILEX, and QUEMAN) 

Deletes the files you specify from a volume's directory or the system queue. 

DELETE filespec1[,filespec2,...] 

RT-11 Command Options 

■ /BEFORE[:date] 
. /SINCE[:date] 
/DATE[:date] 
/NEWFILES 

/ENTRY 

/EXCLUDE 

/INFORMATION 

/LOG 

/POSITION[:sequence-number] 

/[NOJQUERY 

/SYSTEM 

/WAIT 
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Interchange Command Options 

/DOS 

AVAIT 
/INTERCHANGE 

/WAIT 



/BEFORE[:date] 

Deletes only those files created before the specified or (if date is omitted) the 
current system date. The following command deletes all SAV files on DUl that 
were created before March 20, 1991: 

. DELETE /LOG/BEFORE ■.20: MAR : 91 DUl : * . SAV 
Files deleted: 
DYO:A.SAV 
DYO:B.SAV 
DYO:C.SAV 

/DOS 

Deletes files from DOS-11 or RSTS/E disks or DECtapes. 

/ENTRY 

Deletes a job from the system queue. The following example deletes the job 
MILLER from the queue: 

.DELETE/ENTRY MILLER 

/EXCLUDE 

Deletes all the files on a device except the ones you specify. The following command, 
for example, deletes all files from DUl except SAV files: 

. DELETE /EXCLUDE DUl : * . SAV 

/INFORMATION 

Displays informational rather than fatal messages for files not found and deletes 
all others. In the following example, the input files FILE1.TXT and FILE3.TXT are 
deleted. However, since RT-11 is unable to find DU1:FILE2.TXT, RT-11 displays a 
message to inform you: 

. DELETE/INFORMATION DUl : (FILEl , F1LE2, FILE3) . TXT 
?PIP-I-File not found DUl :FILE2 .TXT 

/INTERCHANGE 

Deletes files from an interchange-format diskette. 
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/LOG 

Lists the names of all the deleted files on the terminal. 

/NEWFILES 

Deletes only the files with the current system date. The following example deletes 
the BAK files created today: 

. DELETE /NEWFILES DUl : * . BAK 
DUl: MERGE. BAK ? Y 

/POSITION[:sequence-number] 

Controls the positioning of tapes for deletions. The sequence-number is interpreted 
as the decimal sequence-number of files on a magtape. 

The following table lists the operation initiated by each value of the sequence-number 
specified with the /POSITION:sequence-number option. 

Sequence-Number Operation 

The magtape rewinds and RT-11 searches for the file you specify. 

A positive RT-11 starts from the magtape's present position and searches for 

integer the file you specify. If RT-11 does not find the file you specify before 

it reaches the sequence-numbered file from its starting position, it 

deletes the sequence-numbered file. 

Note: Deleting a sequence-numbered file also deletes any files that 
follow it. 

A negative The magtape rewinds; then RT-11 follows the procedure outlined 

integer in the preceding delete operation. 

/[NOJQUERY 

[Does not] ask for confirmation before executing the command. The following 
example shows querying. Only the file DU1:AAF.MAC is deleted: 

. DELETE/QUERY DUl :*.* 
Files deleted: 
DUl: ABC. MAC ? N 
DU1:AAF.MAC ? Y 
DUl: MERGE. FOR ? N 
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/SINCE[:date] 

Deletes only those files created on or after the specified date or, if no date is 
specified, the current system date. The following command deletes all SAV files on 
DUl that were created on or after March 20, 1991: 

. DELETE/LOG/SINCE : 20 -.MAR : 91 DUl : * . SAV 
Files deleted: 
DUl: A. SAV 
DUl :B. SAV 
DUl :C. SAV 

/SYSTEM 

Allows you to delete system (SYS) files when using wildcards in an input file type. 
If you specify SYS as an input file type, you do not need to specify the /SYSTEM 
option. 

/WAIT 

Initiates the DELETE operation and then waits for the volume to be mounted 
before executing the operation. 



DIBOL 

(DIBOL) 

Invokes the DIBOL compiler to compile one or more source programs. 

DIBOL filespec[s] 

Command Options 

/ALPHABETIZE 

/CROSSREFERENCE 

/[NOILINENUMBERS 

/ALLOCATE:size 
/LOG 
/[NO]OBJECT[:filespec] 

/ALLOCATE:size 
/ONDEBUG 
/PAGE rvalue 
/TABLES 
/[NOIWARNINGS 
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/ALLOCATE :size 

Reserves space on the device for the output file; a size of -1 reserves the largest 
possible space. 

/ALPHABETIZE 

Alphabetizes entries in the symbol table listing. 

/BUFFERING 

Disables double buffering. 

/CROSSREFERENCE 

Generates a symbol cross-reference section in the listing. This is not the default. 

/[NOJLINENUMBERS 

[Does not] generate line numbers in the executable program. 

/LISTi.filespec] 

Outputs a program listing on the printer or in the filespec. 

/LOG 

Creates a log file of error messages generated by the compiler. 

/[NO]OBJECT[:filespec] 

[Does not] produce an OBJ file; the default file name is the input file name. In 
the following command, RT-11 compiles A.DBL and B.DBL together, producing 
files A.OBJ and B.LST. It also compiles C.DBL and produces C.LST, but does not 
produce C.OBJ: 

. DIBOL A+B/LIST, C/NOOBJECT/LIST 

/ONDEBUG 

Includes a symbol table in OBJ file for use with DIBOL DDT. 

/PAGE:value 

Defines the listing page size; the default is 66 lines. 

/TABLES 

Includes label and symbol tables in the listing. 

/[NOJWARNINGS 

[Does not] include warning messages. 
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DIFFERENCES 

(BINCOM and SRCCOM) 

Compares two files and lists the differences between them. 

DIFFERENCES 1st-filespec[s] 2nd-filespec[s] 

Binary File Options 

/ALWAYS 

/BYTES 

/DEVICE 

/END[:value] 

/QUIET 

/SIPP:filespec 

[/ALLOCATE :size] 
/START[:value] 

/OUTPUT:filespec [ '!t™^S^'^^'®'^^ 
L /ALWAYS 

/PRINTER 
/TERMINAL 



/BINARY 



Text File Options 



/BLANKLINES 

/CASE[:option] 

/CHANGEBAR 

/[NOICOMMENTS 

/FORMFEED 

/MATCH[:value] 



/ALLOCATE :size 
/ALWAYS 



/OUTPUT:filespec 

/PRINTER 
/TERMINAL 

/ALLOCATE:size 
L /AUDITTRAIL 



/SLP:filespec 



/[NOJSPACES 
/[NOJTRIM 
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/ALLOCATE :size 

Reserves space for output file; a size of -1 reserves the largest posssible space. 

/ALWAYS 

Creates an output file whether or not differences exist. 

/AUDITTRAIL 

Marks any changes made by SLP so that you have a record of how you patch source 
file. 

/BINARY 

Compares two binary files and lists the differences between them. 

/BLANKLINES 

Includes blank lines in the file comparison. 

/BYTES 

Lists the differences byte by byte. 

/CASE[:option] 

Controls case sensitivity in a file comparison. The two options are EXA for 
case-sensitive comparisons and GEN for case-insensitive comparisons. 

/CHANGEBAR 

Creates an output file that marks additions and deletions in the second file. A 
vertical bar marks an addition; a bullet (lowercase letter o) marks a deletion. The 
following example command creates a listing of RTLIB.MAC with a changebar or 
bullet character at the left margin of each line that is different from RTLIB.BAK: 

.DIFFERENCES /CHANGEBAR RTLIB.BAK RTLIB.MAC 

/[NOJCOMMENTS 

[Does not] include in the file comparison all assembly-language comments found in 
the two files. 

/DEVICE 

Compares two entire volumes starting with block 0. 

/END[:value] 

Specifies the last block to compare. 

/FORMFEED 

Includes form feeds in the output listing. 
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DIFFERENCES 

/MATCH[:value] 

Specifies the number of lines from each file that must agree to constitute a match. 
The default is 3. 

/OUTPUT:filespec 

Specifies a device and file name for the differences listing. The default file type is 
DIF. The following command compares two text files and creates a file EXAMP.DIF 
containing a listing of any differences, if there are differences: 

.DIFFERENCES /OUTPUT :EXAMP EXAMP.ONE EXAMP.TWO 

/PRINTER 

Prints a listing of the differences on the printer. 

/QUIET 

Suppresses the display of the differences at the terminal. 

/SIPP:filespec 

Creates a command file for SIPP, the save-image patch program. The following 
command creates a command file which, when run with SIPP, patches DEMOFl.BAK 
so it matches DEMOFl.SAV: 

DIFFERENCES/BINARY/SIPP : PATCH . COM DEMOFl . BAK DEMOFl . SAV 

/SLP[:filespec] 

Creates a command file for SLP, the source-language patch program (SLP). The 
following command creates the command file PATCH. SLP, which can be used as 
input to the SLP program to patch RTLIB.BAK so that it matches RTLIB.MAC: 

.DIFFERENCES /SLP -.PATCH RTLIB.BAK RTLIB.MAC 

/[NOJSPACES 

[Does not] include spaces and tabs in the file comparison. 

/START[:value] 

Specifies the octal starting block number of the file comparison. 

/TERMINAL 

Displays the list of differences on the terminal. 

/[NOJTRIM 

[Does not] ignore tabs and spaces at the ends of lines. 
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(DIR) 

Lists volume directory information. 

DIRECTORY filesped, filespec2, 



RT-11 Directory Options 



/BEGIN 

/BADBLOCKS 
/END lvalue 
/FILES 
/START:value 
AVAIT 
■ /ALPHABETIZE 

/REVERSE 
/ORDER[:category] 

/REVERSE 
/POSITION 
/SORT[:category] 

/REVERSE 

/BEFORE[:date] 
/SINCE[:date] 

/DATE[:date] 

/NEWFILES 

/BLOCKS 

/BRIEF 

/COLUMNS 

/DELETED 

/EXCLUDE 

/FAST 

/FREE 

/FULL 

/OCTAL 

/[NOJPROTECTION 

/SUMMARY 

/VOLUMEID[:ONLY] 
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DIRECTORY 



RT-11 Directory Options 



/OUTPUT:filespec 

/ALLOCATE :size 
/PRINTER 
/TERMINAL 



Command Options for Interchange Directories 



/BRIEF 
■ /DOS 

/OWNER:[nnn,nnn] 

/WAIT 
/INTERCHANGE 

/WAIT 
/TOPS 

AVAIT 

/FAST 
/OUTPUT:filespec 

/ALLOCATE :size 
/PRINTER 
/TERMINAL 



/ALLOCATE :size 

Reserves space for the output listing file; a size of -1 reserves the largest possible 
space. 

/ALPHABETIZE 

Lists directory entries in alphabetical order. 

/BADBLOCKS 

Scans a volume for badblock and lists their block numbers. 

/BEFORE[:date] 

Lists files created before date. The following command lists on the terminal all files 
stored on device DUl created before February 1991: 

. DIRECTORY/BEFORE : 1 : FEB : 91 DUl : 
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/BEGIN 

Lists the directory beginning at the file you specify. The following example lists the 
file SRCCOM.SAV on device DUl and all the files that follow it in the directory: 

. DIRECTORY DUl : SRCCOM. SAV/BEGIN 

/BLOCKS 

Includes the starting block numbers of files and free areas in the directory listing. 

/BRIEF 

Lists only file names and types; equivalent of /FAST. 

/COLUMNS lvalue 

Lists a directory in the specified number of columns (from 1 to 9). 

. DIRECTORY/COLUMNS : 1 DUl : 

/DATE[:date] 

Lists only those files created on the specified date. The default is the current 
date. The following command lists all the files on device DUl that were created on 
February 15, 1991: 

. DIRECTORY/DATE :15: FEB : 91 DUl : 

/DELETED 

Lists files that have been deleted: 

. DIRECTORY /DELETED DUl : 

/DOS 

Lists the directory of a device that is in RSTS/E or DOS-11 format. 

/END-.value 

Specifies the final block of a bad-block scan. 

/EXCLUDE 

Lists all files except those you specify. The following command lists all files on DUl 
except the SAV and SYS files: 

. DIRECTORY /EXCLUDE DUl: (*. SAV, *.SYS) 

/FAST 

Lists only file names and types; equivalent of /BRIEF. 
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DIRECTORY 

/FILES 

Lists names of files having bad blocks: 

. DIRECTORY/BADBLOCKS/FILES DUl : 

/FREE 

Lists a directory of unused areas and the size of each. 

/FULL 

Lists file names, free areas, sizes, and creation dates. The following example lists 
the entire directory for device DUl: 



.DIRECTORY/FULL DUl: 


















15-Feb-91 




















RTllXM.SYS 


123P 31- 


-Oct- 


-90 


SWAP 


.SYS 


28P 


31- 


-Oct- 


-90 


DU . SYS 


lOP 31- 


-Oct- 


-90 


SL 


.SYS 


17P 


31- 


-Oct- 


-90 


LD . SYS 


IIP 31- 


-Oct- 


-90 


PIP 


.SAV 


3 OP 


31- 


-Oct- 


-90 


DUP . SAV 


52P 31- 


-Oct- 


-90 


DIR 


.SAV 


19P 


31- 


-Oct- 


-90 


RESORC . SAV 


32P 31- 


-Oct- 


-90 


MEMOl 


.TXT 


2 


15- 


-Feb- 


-91 


< UNUSED > 


2 






MEM03 


.TXT 


2 


15- 


-Feb- 


-91 


< UNUSED > 


458 



















11 Files, 326 Blocks 
460 Free blocks 

/INTERCHANGE 

Lists the directory of a diskette that is in interchange format. 

/NEWFILES 

Lists only those files with the current system date: 

. DIRECTORY/NEWFILES DUl : 

/OCTAL 

Lists in octal sizes and, if /BLOCK is used, starting blocks. 

/ORDER[:category] 

Sorts the directory listing by category; category can be any of the following. 

Category Function 

DATE creation date 

NAME file name 

POSITION file position on the volume 

SIZE file size in blocks 

TYPE file type 
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The following example lists the directory of device DUl, according to date: 

. DIRECTORY/ORDER : DATE DUl : 

/OUTPUTJilespec 

Specifies a device and file name for the listing file. Normally, the directory listing 
appears on the terminal. 

/OWNER:[nnn,nnn] 

Specifies a user identification code (UIC) for a DOS formatted volume; the square 
brackets are a part of the UIC. 

/POSITION 

Lists the files in the order that they occur on the volume (the default); includes file 
sequence numbers of files stored on a magtape or starting block numbers of files on 
disk. 

/PRINTER 

Prints the directory listing on the printer. 

/[NOJPROTECTION 

Lists all [unjprotected files on a volume. 

. DIRECTORY/ORDER : SIZE/REVERSE/PROTECTION 

15-Feb-91 
RTllXM.SYS 123P 31-Oct-90 
DUP .SAV 52P 31-Oct-90 

RESORC.SAV 32P 31-Oct-90 

PIP .SAV 30P 31-Oct-90 

SWAP .SYS 28P 31-Oct-90 

9 Files, 322 Blocks 

460 Free blocks 

/REVERSE 

Lists a directory in the reverse order of the sort you specify with /ALPHABETIZE, 
/ORDER, or /SORT 

/SINCE[:date] 

Lists all files created on or after the specified date. 

. DIRECTORY/SINCE : 13: AUG: 90 

/SORT[:category] 

Equivalent to /ORDER. 

/START:value 

Specifies the starting block for a bad-block scan. 
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DIR 


.SAV 


19P 


31-Oct-90 


SL 


.SYS 


IIP 


31-Oct-90 


LD 


.SYS 


IIP 


31-Oct-90 


DU 


.SYS 


lOP 


31-Oct-90 



DIRECTORY 



/SUMMARY 

Lists the number of files, the blocks in use, and the free blocks on a volume. 

. DIRECTORY/SUMMARY 
14-Mar-91 



44 


Files 


in 


segment 


1 


46 


Files 


in 


segment 


4 


37 


Files 


in 


segment 


2 


34 


Files 


in 


segment 


5 


38 


Files 


in 


segment 


3 



16 Available segments, 5 in use 
199 Files, 3647 Blocks 
1115 Free blocks 

/TOPS 

Lists the directory of a DECsystem-10 DECtape. 

/VOLUMEID[:ONLY] 

Includes the volume ID and owner name at the beginning of the directory listing; 
with ONLY, lists just the volume ID and the owner name. 

.DIRECTORY/VOLUMEID DUl : 
15-Feb-91 



Volume ID: 


RTllA 
















Owner 


Harry 
















RTllXM.SYS 


123P 31-Oct- 


-90 


SWAP 


.SYS 


28P 


31- 


-Oct- 


-90 


DU . SYS 


lOP 31-Oct- 


-90 


SL 


.SYS 


17 P 


31- 


-Oct- 


-90 


LD . SYS 


IIP 31-Oct- 


-90 


PIP 


.SAV 


3 OP 


31- 


-Oct- 


-90 


DUP . SAV 


52P 31-Oct- 


-90 


DIR 


.SAV 


19P 


31- 


-Oct- 


-90 


RESORC.SAV 


32P 31-Oct - 


-90 


MEMOl 


.TXT 


2 


15- 


-Feb- 


-91 


MEM03 .TXT 


2 15-Feb- 


-91 














11 Files, 


326 Blocks 
















460 Free blocks 

















/WAIT 

Waits for the volume to be mounted before executing the command. 
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DISMOUNT 

(KMON) 

Frees a logical-disk unit number from its associated file. 

DISMOUNT logical-disk-unit 

For example: 

.DISMOUNT LD3: 

or 

.ASSIGN LD3: DAT 
.DISMOUNT DAT 



DUMP 

(DUMP) 

Lists the contents of file in octal words, octal bytes, ASCII characters, or Radix-50 
characters. 



DUMP filespec 



Command Options 



/[NOJASCII 

/BYTES 

/END:value 

/FOREIGN 

/IGNORE 

/ONLY:value 

/OUTPUT:filespec 
/ALLOCATE :size 

/PRINTER 

/TERMINAL 

/RAD50 

/START:value 

AVORDS 
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DUMP 

/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/[NOJASCII 

[Does not] list the ASCII equivalent of each octal word or byte. 

/BYTES 

Lists information in octal bytes. 

/END:value 

Specifies the last block to dump. 

/FOREIGN 

Dumps a magtape that is not RT-11 file-structured. 

/IGNORE 

Ignores I/O errors that occur during a dump operation. 

/ONLY:value 

Dumps only the block you specify. 

/OUTPUTJilespec 

Sends the output to the fiilespec. 

/PRINTER 

Sends the output to the printer. 

/RAD50 

Lists the Radix-50 equivalent of each octal word. 

/START.value 

Specifies the first block to dump. 

/TERMINAL 

Sends the output to the terminal. 

/WORDS 

Lists information in octal words. 
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E (Examine) 

(KMON) 

Displays in octal the contents of an address on the console terminal. 

E address1[-address2]) 

For example: 

.E 1000 

127401 

or 

.E 1001-1005 

127401 007624 127400 



EDIT 

(EDIT, KED, KEX, TECO) 

Runs a text editor for creating or modifying ASCII files. KED is the default editor 
for an unmapped monitor; KEX is the default editor for a mapped monitor. 



EDIT filespec 



Command Options 



Filespec Options 



( /EDIT 



f /KED "I 
I /KEX J 



/[N0]COMMAND[:init-filespec] 
/JOURNAL[:jour-filespec] 
/[NOIQUERY 
/RECOVER[:jour-filespec] 



/ALLOCATE:size 



/TECO 

/EXECUTErfilespec 

/CREATE 

/INSPECT (or /READONLY) 
/OUTPUTfilespec 
/ALLOCATE :size 
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EDIT 

/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

. EDIT/CREATE DUl : PROGl . MAC /ALLOCATE : -1 

/[NO]COMMAND[:init-filespec] 

(KED/KEX only) [Does not] execute the initialization file KEDINI.KED or the 
specified initialization file. The following command executes the initialization file 
myinit.ked before beginning the work session: 

EDIT/COMMAND :my±n±t .ked myflle.txt 

/CREATE 

Creates a new file when the specified input file is not found. 

.EDIT/CREATE NEWFIL.TXT 

/EDIT 

Invokes the EDIT line editor. 

/EXECUTE:filespec 

Executes TECO commands contained in the file you specify. 

/INSPECT 

Opens a file with read-only access. 

. EDIT/INSPECT NEWFIL . TXT 

/JOURNAL[:jour-filespec] 

(KED/KEX only) Produces a journal file that will let you recover your work after a 
system crash or similar malfunction. The default journal file name is your output 
file name with a JOU file type. 

.EDIT/ JOURNAL PROGl. FOR 

/KED 

Invokes the KED keypad editor, the default editor for unmapped monitors: 

.EDIT/KED PROGl. FOR 

/KEX 

Invokes the KEX keypad editor, the default editor for mapped monitors: 

.EDIT/KEX PROGl. FOR 
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EDIT 

/OUTPUT:filespec 

Specifies a new file to contain the output of your work session, leaving the input 
file unchanged: 

. EDIT/OUTPUT : PR0G2 . FOR PROGl . FOR 

/[NOJQUERY 

[Does not] request confirmation before executing some commands, such as creating 
a new file: 

.EDIT/NOQUERY MEMO20.TXT 

/READONLY 

Opens a file as read only. This is the same as /INSPECT. 

/RECO VER[:jour-filespec] 

Produces a text file containing the work in your editing session that was terminated 
without an EXIT or QUIT command. In executing the following command, RT-11 
looks for the journal file MEMO20.JOU: 

.EDIT/RECOVER MEMO20.TXT 

/TECO 

Invokes the TECO editor. (TECO is not supported or distributed by Digital.) 
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EXECUTE 

(DIBOL, CREF, F77, F77XM, FORTRA, LINK, and MACRO) 

Invokes one or more language processors, compiles or assembles source files, and 
then links and runs the resulting modules. 

EXECUTE filespec[s] 



Command Options 



Filespec Options 



/BOTTOM:value 
/DEBUG[:filespec] 
/DUPLICATE 
/EXECUTE[:filespec] 

/ALLOCATE:size 
/GLOBAL 

/LINKLIBRARY:filespec 
/LIST[:filespec] 

/ALLOCATE :size 
/MAP[:filespec] 

/ALLOCATE :size 

AVIDE 
/OBJECT[:fllespec] 

/ALLOCATE :size 
/PROMPT 
/[NO]RUN 



[ /LIBRARY[:filespec] ] 
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EXECUTE 



Command Options 



Filespec Options 



/DIBOL 



/FORTRAN 



/ALPHABETIZE 
/BUFFERING 
/CROSSREFERENCE 
/[NO]LINENUMBERS 

/LOG 

/ONDEBUG 
/PAGE: value 
/TABLES 
/[NOJWARNINGS 

/CHECK 

/CODE:type 

/CONTINUATIONS:value 

/DIAGNOSE 

/EXTEND 

/F4 or /F77 

/HEADER 

/I4 

/[NO]LINENUMBERS 

/ONDEBUG 

/[NO]OPTIMIZE 

/RECORD:length 

/SHOW[:TYPE] 

/STATISTICS 

/[NO]SWAP 

/TRACE :type 

/UNITS:value 

/[NO]VECTORS 

/[NO]WARNINGS 

/WIDE 

AVORKFILE 



/MACRO 



/CROSSREFERENCE[:type[:type...]] 
/DISABLE:type[:type...] 
/ENABLE:type[:type...] 
/[NO]SHOW:type[ :type. . .] 



/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/ALPHABETIZE 

(DIBOL only) Alphabetizes the symbol table listing. 

/BOTTOM:value 

Specifies the lowest address to be used by the relocatable code in the load module. 
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/BUFFERING 

(DIBOL only) Disables double buffering. 

/CHECK 

(FORTRAN-77 only) Checks array references to ensure they are within the specified 
array address boundaries. 

/CODE:type 

(FORTRAN IV only) Controls type of code generated; type can be EAE, EIS, and 
THR. 

/CONTINUATIONS:value 

(FORTRAN-77 only) Specifies the maximum decimal number of continuation lines 
in the program. The range is through 99; the default is 19. 

/CROSSREFERENCE[:type[:type...]] 

(DIBOL and MACRO) Generates a cross reference listing of symbols; type can be: 

C (Control section names) M (Macro names) 
E (Error codes) P (Permanent symbols) 

R (Register symbols) S (User-defined symbols) 

no argument — equivalent to :E:M:S 

/DEBUG[:filespec] 

Links ODT [or another debugger] with your program. 

/DIAGNOSE 

(/FORTRAN IV only) Expands the crash dump information to include internal 
compiler tables and buffers. 

/DIBOL 

Runs the DIBOL compiler. 

/DISABLE:type[:type...] 

(MACRO only) Specifies .DSABL directives; type can be: 

ABS Generates absolute binary output. 

AMA Assembles absolute addresses as relative addresses. 

CDR Treats source columns beyond 72 as a comment. 

DBG Outputs internal symbol directory (ISD) records. 

FPT Truncates floating point. 
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GBL Assumes undefined symbols are globals. 

LC Accepts lowercase characters in source programs. 

LSB Defines local symbol block. 

MCL Enables or disables automatic .MCALL. 

PNC Enables or disables binary output. 

REG Defines default register mnemonics. 

/DUPLICATE 

Allows multiple copies of library modules when linking. 

/ENABLE:type[:type...] 

(MACRO only) Specifies .ENABL directive; types are listed under /DISABLE. 

/EXECUTE[:filespec] 

Specifies a file or device for the executable file; the default file name is the input 
file name. The following command creates an executable file called PROGl.SAV on 
device DUl: 

. EXECUTE /EXECUTE :DU1 : PROGl , PR0G2 

The next command creates an executable file called MYPROG.SAV on device DK: 

. EXECUTE RTNl , RTN2, MYPROG/EXECUTE 

/EXTEND 

(/FORTRAN IV) Extends the right margin of input lines from column 72 to column 
80. 

(/FORTRAN-77) Extends the right margin of input lines from column 72 to column 
132. 

/F4 

Overrides any SET FORTRA conditional and calls the FORTRAN IV compiler (the 
default). 

/F77 

Overrides any SET FORTRA conditional and calls the appropriate FORTRAN-77 
compiler. 

/FORTRAN 

Runs the FORTRAN compiler. 



3-46 RT-11 Commands 



EXECUTE 

/GLOBAL 

Includes a cross reference of global symbols as a part of the load map listing. The 
following command produces a map listing file, MYPROG.MAP, that contains a 
global symbol cross-reference section: 

. EXECUTE/GLOBAL/MAP : DUl : MYPROG 

/HEADER 

(/FORTRAN IV only) Includes a list of the current options in the printout. 

/I4 

(FORTRAN IV or FORTRAN-77) Allocates 2-word integers. 

/LIBRARY 

(MACRO only) Identifies the file this option qualifies as a macro library file: 

. EXECUTE A+B/LIST/OBJECT, MYLIB/LIBRARY+C . MAC/LIST/OBJECT 

/[NOJUNENUMBERS 

(DIBOL, FORTRAN IV, or FORTRAN-77) [Does not] include hne numbers in the 
executable program. 

/UNKUBRARYJilespec 

Includes the file as a library at link time. 

/USTi.filespec] 

Produces a compilation or assembly listing on the printer or to the filespec. The 
following command creates a listing file called A.LST on DUl: 

. EXECUTE /LIST :DU1: A. MAC 

/LOG 

(DIBOL only) Creates a log file of error messages generated by the compiler. 

/MACRO 

Runs the MACRO assembler. 

/MAP[:filespec] 

Sends a load map to the printer or to the filespec. 

/OBJECT[:filespec] 

Specifies a file name for the OBJ file. 

/ONDEBUG 

(DIBOL, FORTRAN IV, or FORTRAN-77) Includes symbol names in the output file 
for use with DIBOL DDT; includes debug lines in FORTRAN compilation. 
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/[NOJOPTIMIZE 

(FORTRAN-77 only) [Does not] enable compiler optimization. 

/PAGE:value 

(DIBOL only) Specifes the number of lines on a listing page; the default is 66. 

/PROMPT 

Accepts input lines until a terminating double slash (//) is found. 

/RECORD.Iength 

(FORTRAN IV or FORTRAN-77) Overrides the default record length of 132 
characters; valid range is from 4 to 4095. 

/[NO]R\iH 

[Does not] run the program after linking. 

/[NO]SHOW:type 

(MACRO only) Specifies the MACRO [.NLIST] and .LIST directives; type can be: 

BEX Extended binary code 

BIN Generated binary code 

CND Unsatisfied conditions and .IF and .ENDC statements 

COM Comments 

LOC Location counter 

LD Listing directives with no arguments 

MC Macro calls, repeat range expansions 

MD Macro definitions, repeat range expansions 

ME Macro expansions 

MEB Macro expansions, binary code 

SEQ Source line sequence numbers 

SRC Source code 

SYM Symbol table 

TOC Table of contents 

TTM Wide or narrow listing format 

/SHOW -.type 

(FORTRAN IV, FORTRAN-77) Controls FORTRAN listing format. See the 
FORTRAN command description for the types you can use. 

/STATISTICS 

(FORTRAN IV or FORTRAN-77) Includes compilation statistics in the listing. 
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/[NOJSWAP 

(FORTRAN IV or FORTRAN-77) [Does not] permit the USR to swap over the 
FORTRAN program in memory. 

/TABLES 

(DIBOL only) Includes lable and symbol tables in the listing. 

/TRACE:type 

(FORTRAN-77 only) Enables the FORTRAN-77 /S:xxx option. 

/UNITS:value 

(FORTRAN IV or FORTRAN-77) Specifies the number of FORTRAN logical units; 
the initial value is 6; maximum is 16 (for FORTRAN IV) or 99 (for FORTRAN-77). 

/[NOJVECTORS 

(FORTRAN IV only) [Does not] access FORTRAN multidimensional arrays by 
building tables of pointers. 

/[NOJWARNINGS 

(DIBOL, FORTRAN IV, or FORTRAN-77) [Does not] include warning messages. 

/WIDE 

(FORTRAN-77 only) Produces a 132-column compiler listing. 

/WORKFILE lvalue 

(FORTRAN-77 only) Sets the workfile size; the default is 128io blocks. Include a 
decimal point after value to specify a decimal radix. 



FORMAT 

(FORMAT) 

• Formats some disks and diskettes by writing headers to each block in the 
volume 

• Verifies that blocks on disks and diskettes can be read from or written to. 

• Replaces bad blocks (ones from/to which you cannot read/write) on a device with 
good blocks. 

FORMAT device: 
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FORMAT 

Command Options 



/[NOIQUERY 

/SINGLEDENSITY 

A^ERIFY[:ONLY] 

/PATTERN:value 
AVAIT 



You can FORMAT and A/'ERIFY the following devices: 

DW devices (Devices for Professional 300 Series processors) 

RK05 

RK06/RK07 

RXOl and RX02 on RX02 drives 

RX33 

You can only A^ERIFY [:ONLY] the following devices: 

RL01/RL02 

RXOl 

RX50 
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FORMAT 



/PATTERN[:value] 

specifies which of the following 16-bit patterns to use for verification: 



Pattern 



Bit Set 



Value 



16-Bit Pattern 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 



1 

2 

4 

10 

20 

40 

100 

200 

400 

1000 

2000 

4000 

10000 

20000 

40000 

100000 



000000 
177777 
163126 
125252 
052525 
007417 
021042 
104210 
155555 
145454 
146314 
162745 

* 



*These patterns are reserved for future use. Currently these bit patterns run the 
default bit pattern (pattern 8). 



.FORMAT/VERIFY/PATTERN: 25 DLO : 
DLO : /FORMAT-Are you sure? Y 
?FORMAT-I-Formatt±ng complete 
PATTERN 5 
PATTERN 3 
PATTERN 1 
?FORMAT-I-Ver±f±cat±on complete 

/[NOJQUERY 

[Does not] ask for confirmation before formatting. 
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/SINGLEDENSITY 

Formats diskette in single-density format: 

. FORMAT /SINGLEDENSITY DYl : 

/VERIFY[:ONLY] 

Verifies after formatting; with ONLY, verifies without formatting; but its verification 
procedure is destructive of information already on the volume. 

.FORMAT/VERIFY DUl : 
DU2 : /FORMAT-Are you sure? Y 
?FORMAT-I-Formatt±ng complete 
PATTERN 8 
?FORMAT-I-Ver±f±cat±on complete 

/WAIT 

Waits for the volume to be mounted before executing the command. 

.FORMAT/WAIT DUl: 

DUl : /FORMAT-Are you sure? Y 

Mount input volume in <device>; Continue? Y 

?FORMAT-I-Formatting complete 

Mount system volume in <device>; Continue? Y 
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FORTRAN 

(FORTRA.SAV, F77.SAV, F77XM.SAV) 

Runs a FORTRAN (FORTRAN IV or FORTRAN-77) compiler (FORTRAN IV by 
default). 

FORTRAN filespec[s] 



FORTRAN IV Command 
Options 



FORTRAN-77 Command 
Options 



/CODE:type 

/DIAGNOSE 

/EXTEND 

/F4 

/HEADER 

/I4 

/[NOJLINENUMBERS 

/LIST[:filespec] 

/ALLOCATE:size 
/[NO]OBJECT[:filespec] 

/ALLOCATE:size 
/ONDEBUG 
/RECORD:length 
/SHOW[:type] 
/STATISTICS 
/[NOISWAP 
/UNITS:value 
/[NOJVECTORS 
/[NOIWARNINGS 



/CHECK 

/CONTINUATIONS 

/EXTEND 

/F77 

/I4 

/[NOILINENUMBERS 

/LIST[:filespec] 

/ALLOCATE :size 
/[NO]OBJECT[:filespec] 

/ALLOCATE :size 
/ONDEBUG 
/[NOjOPTIMIZE 
/RECORD:length 
/SHOW[:type] 
/STATISTICS 
/[NOISWAP 
/TRACE :type 
/UNITS:value 
/[NOIWARNINGS 
/WIDE 
AVORKFILE lvalue 



/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/CHECK 

(FORTRAN-77 only) Checks array references to ensure they are within the specified 
array address boundaries. 

/CODE:type 

(FORTRAN IV only) Control type of code generated; type can be EAE, EIS, FIS, or 
THR. 
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/CONTINUATIONS:value 

(FORTRAN-77 only) Specifies the maximum decimal number of continuation lines 
in the program. The range is through 99io; the default is 19. 

/DIAGNOSE 

(FORTRAN IV only) Expands the crash dump information. 

/EXTEND 

Extends the right margin of input lines from 72 to 80 columns (for FORTRAN IV) 
and from 72 to 132 columns (for FORTRAN-77). 

/F4 

Calls the FORTRAN IV compiler (the default). 

/F77 

Calls the appropriate FORTRAN-77 compiler. 

/HEADER 

(FORTRAN IV only) Includes a list of the current options in the printout. 

/I4 

Allocates 2-word integers. 

/[NO]LINENUMBERS 

[Does not] include line numbers in the executable program. 

/LIST[:filespec] 

Sends the compiler listing to the printer or to the file specification. 

/[NO]OBJECT[:filespec] 

[Does not] generate an OBJ file. 

/ONDEBUG 

Includes debug lines (those that have a D in column one) in the compilation. 

/[NOJOPTIMIZE 

(FORTRAN-77 only) [Does not] enable compiler optimization. 

/RECORD.Iength 

Overrides the default record length of 132 characters; the valid range is from 4 to 
4095. 

/SHOW[:typel 

Controls FORTRAN listing format; the type codes are as follows. 
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FORTRAN 



FORTRAN IV Listing Options 



Diagnostics only 

1 or SRC Source program and diagnostics 

2 or MAP Storage map and diagnostics 

3 Diagnostics, source program, and storage map 

4 or COD Generated code and diagnostics 
7 or ALL All of the above 



FORTRAN-77 Listing Options 



Minimal listing; diagnostics and program section summary 
only 

1 Source listing and program section summary 

2 Source listing, program section summary, and storage map 
(the default) 

3 Source listing, assembly code, program section summary, and 
section map 

/STATISTICS 

Includes compilation statistics in the listing. 

/[NOJSWAP 

[Does not] permit the USR to swap over the FORTRAN program in memory. 

/TRACE:type 

(FORTRAN-77 only) Enables the FORTRAN-77 /S:xxx option; types can be: 

Type Value Description of Compiled Traceback Information 

(omitted) Same as the /NOLINENUMBERS option 

ALL All source statements, functions, and subroutine entries 

LIN Same as ALL 

BLO Selected source statements, all functions, and all subroutine 

entries (the default) 

NAM All function and subroutine entries 

NON None compiled 
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/UNITS:value 

Specifies the number of FORTRAN logical units; the initial value is 6; maximum is 
16 (for FORTRAN IV) or 99 (for FORTRAN-77). 

/[NOJVECTORS 

(FORTRAN IV only) [Does not] access FORTRAN multidimensional arrays by 
building tables of pointers. 

/[NOJWARNINGS 

[Does not] include warning messages. 

/WIDE 

(FORTRAN-77 only) Produces a 132-column compiler listing. 

/WORKFILE lvalue 

(FORTRAN-77 only) Sets the workfile size; the default is 128io blocks. Include a 
decimal point after value to specify a decimal radix. 
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FRUN 

(KMON) 

Initiates foreground jobs on multi-job monitors. See also R, RUN, SRUN, VA/^RUN. 

FRUN filespec 

Filespec Options 

/BUFFER:value 
/NAME:name 
/PAUSE 
/TERMINAL:value 



/BUFFER lvalues 

Reserves more space (words) in memory than the actual program size. 

/NAME:name 

Assigns a logical name to the foreground job. 

/PAUSE 

Displays the load address of your foreground job and waits for a RESUME. 

.FRUN DEMOSP /PAUSE 
Loaded at 127276 
.RESUME 

/TERMINAL lvalue 

Assigns the specified terminal to the foreground job. 



GET 

(KMON) 

Loads a memory image file into memory. 

GET filespec 
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(HELP) 

Displays concise DCL command descriptions with examples. 

HELP [ topic [subtopic[:item[:item...] ] ] ] 

Command Options 

/TERMINAL 

/PRINTER 



/PRINTER 

Prints the help information on the printer. 

/TERMINAL 

Displays the HELP information on the terminal. 

1. The HELP * command lists and briefly describes all the RT-11 DCL commands: 

.HELP * 

ABORT Terminates, from the system console, a Foreground job 

ASSIGN Associates a logical device name with a physical device 

B Sets a relocation base 

BACKUP Backup/Restore large files on random access devices 



2. The HELP DATE command displays a brief description of the DATE command: 

.HELP DATE 

DATE Sets or displays the current system date 

SYNTAX 

DATE[ dd-mmm-yy] 

SEMANTICS 

All numeric values are decimal; mmm represents the 
first three characters of the name of the month. Under 
RTEM-11, the current date cannot be changed. 

OPTIONS 

None 

EXAMPLES 

DATE 12-MAR-90 
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INITIALIZE 

(DUP and FILEX) 

Writes an RT-11 empty device directory on the specified volume. 

INITIALIZE device: 

RT-11 Command Options 

/BADBLOCKS[:RETAIN] 

/FILE:filespec 

/[NOIQUERY 

/REPLACE[:RETAIN] 

/SEGMENTS:value 

A^OLUMEID[:ONLY] 

AVAIT 

/RESTORE 

Interchange Command Options 

/DOS 

AVAIT 
/INTERCHANGE 

/WAIT 
/[NOIQUERY 
/VOLUMEID[:ONLY] 



/BADBLOCKS[:RETAIN] 

Scans a volume for bad blocks and creates FILE. BAD directory entries; with 
RETAIN, retains the existing FILE.BAD files but does not scan for bad blocks. If 
the volume being initialized contains bad blocks, RT-11 displays the locations of 
the bad blocks in octal and in decimal, as in the following example: 

. INITIALIZE/BADBLOCKS DLO : 

DLO : /Initialize; Are you sure? Y 

Block Type 

000120 80. Hard 

000471 313. Hard 

000521 337. Hard 

?DUP-W-Bad blocks detected 3. 



/DOS 

Initializes a DECtape for DOS-11 format. 
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/FILE:filespec 

Initializes a magtape and creates a bootable tape. The following example creates a 
bootable magtape on an MS device: 

. INITIALIZE/FILE : MSBOOT . EOT MSO : 

/INTERCHANGE 

Initializes a diskette for interchange format. 

/[NOJQUERY 

[Does not] ask for confirmation before initialization. 

/REPLACE[:RETAIN] 

Detects bad blocks and creates [or retains the old] bad-block replacement table. 

/RESTORE 

Restores the previous directory on an initialized volume. You can use /RESTORE 
only if no files have been transferred to the volume since it was initialized. 

/SEGMENTS:value 

Specifies the number of directory segments to allocate. 

Default Directory Sizes 

Decimal Number of 
Device Segments in Directory 



DW (RD50) 


16 


DW (RD51) 


31 


DX (RXOl) 


1 


DY (RX02 single-density) 


1 


DY (RX02 double-density) 


4 


DZ (RX50) 


4 


DL (RLOl) 


16 


DL (RL02) 


31 


DM (RK06/07) 


31 


DU (Winchester disks) 


31 


DU (Diskettes) 


1 


RK (RK05) 


16 
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/VOLUMEID[:ONLY] 

Asks for owner name and volume ID during the initialization; with ONLY, writes a 
new owner name and volume ID without changing the directory. 

. INITIALIZE/VOLUMEID DUl : 

DUl: /Initialize; Are you sure? Y 

Volume ID? FORTRAN VOL 

Owner? AJAX-CORP 

/WAIT 

Waits for a volume to be mounted before executing the command. 



INSTALL 

(KMON) 

Enters the device you specify into the monitor's internal tables. 

INSTALL device[,device,...] 

An example situation in which you might use INSTALL: 

.COPY SDH. SYS SD.SYS 
. UNLOAD SD 
.REMOVE SD 
.INSTALL SD 
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(LIBR) 

Lets you create, update, modify, list, and maintain library files. 

LIBRARY input-files 



Command Options 



Input-File Options 



/EXTRACT 

/CREATE 
/DELETE 
/INSERT 

/LIST[:filespec] 
/ALLOCATE :size 

/[N0]OBJECT[:filespec] 
/ALLOCATE :size 

/PROMPT 

/REMOVE 

/MACRO[:value] 
/CREATE 
/PROMPT 



/REPLACE 
/UPDATE 



/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 
This example uses /ALLOCATE to create the .OBJ library MYLIB.OBJ from the 
.OBJ library MYFILE.OBJ: 

LIBRARY/OBJECT :MYLIB/ALLOCATE : -1 MYFILE 

/CREATE 

Creates a new .OBJ library. The following command creates a library called 
NEWLIB.OBJ from the modules contained in files FIRSTOBJ and SECOND.OBJ: 

.LIBRARY/CREATE NEWLIB FIRST, SECOND 
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/DELETE 

Deletes an .OBJ module from a library. The following example deletes modules 
SGN and TAN from the library called NEWLIB.OBJ: 

.LIBRARY/DELETE NEWLIB 
Module name? SGN 
Module name? TAN 
Module name? 

/EXTRACT 

Retrieves an .OBJ module from a library and stores it in a separate file. The 
following example retrieves module ATAN from NEWLIB.OBJ library and stores it 
in the file ATAN.OBJ: 

.LIBRARY/EXTRACT [r|t] 
Library? NEWLIB (Rfr] 
File ? DU1:ATAN [ret] 
Global ? ATAN [r|t] 
Global 7 



/INSERT 

Adds an .OBJ module into an existing library. The following example inserts the 
modules contained in the files THIRD.OBJ and FOURTH.OBJ into the library 
called OLDLIB.OBJ: 

.LIBRARY/INSERT OLDLIB THIRD, FOURTH 

/LIST[:filespec] 

Sends a directory listing of an .OBJ library to the printer or the filespec. 

/MACRO[:value] 

Creates a macro library. The value specifies the size in block of the macro name 
directory. The following example creates a macro library called NEWLIB. MLB from 
the ASCII input file SYSMAC.MAC: 

.LIBRARY/MACRO/CREATE NEWLIB SYSMAC 

/[NO]OBJECT[:filespec] 

[Does not] create a new .OBJ library from an old library; the output file name 
defaults to the input file name. The following example creates a library called 
NEWLIB.OBJ, which consists of the library OLDLIB.OBJ plus the modules that 
are contained in files THIRD.OBJ and FOURTH.OBJ: 

.LIBRARY/ INSERT/OBJECT: NEWLIB OLDLIB THIRD, FOURTH 
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/PROMPT 

Allows more than one line of input files; terminate with two backslashes (//). The 
following example creates a macro library called MACLIB.MLB from seven input 
files: 

.LIBRARY/MACRO/PROMPT MACLIB A,B,C,D 

*E,F,G 

*// 



/REMOVE 

Deletes global symbols from a library file's directory. The following example deletes 
the globals GA, GB, GO, and GD from the library OLDLIB.OBJ: 

.LIBRARY /REMOVE OLDLIB |REtI 

Global? GA [r|t] 

Global? GB [RET] 

Global? GC [ret] 

Global? GD ]ret] 

Global? [ret] 

/REPLACE 

Replaces existing modules with modules of the same name. The following example 
replaces a module SQRT in the library MATHLB.OBJ with a new module, also 
called SQRT, from the file MFUNCTOBJ: 

.LIBRARY MATHLB MFUNCT /REPLACE 

/UPDATE 

Combines the functions of /INSERT and /REPLACE. The following example updates 
the library OLDLIB.OBJ: 

.LIBRARY OLDLIB FIRST/UPDATE, SECOND/UPDATE 
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LINK 

(LINK) 

Combines .OBJ modules into a program that can be run. 

LINK filespecs 



Command Options 



/ALPHABETIZE 

/[NOJBITMAP 

/DEBUG[:filespec] 

/DUPLICATE 

/[NO]EXECUTE[:filespec] 

/ALLOCATE :size 
/EXTEND[:value[:type]] 
/FILL:value[:type] 
/GLOBAL 
/IDSPACE 
/INCLUDE 
/LIBRARY:filespec 
/LINKLIBRAEY:filespec 

/ALLOCATE:size 



AVIDE 



/MAP[:filespec] 

/PROMPT 

/ROUND:value[:type] 

/SLOWLY 

/STACK[:value[:type]] 

/SYMBOLTABLE[:filespec] 

/TRANSFER[:value] 

/BOTTOM:value[:type] 

/BOUND ARY[:value[:type]] 

/FOREGROUND[:stacksize] 

/LDA 

/RUN 

/TOP:value[:type] 

/XM 

/LIMITivalue 
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/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/ALPHABETIZE 

Alphabetically lists the global symbols in the load map. 

/[NO]BITMAP 

[Does not] create a memory usage bitmap. 

/BOTTOM:value[:type] 

Specifies the lowest address to be used by the relocatable code in the load module. 
Invalid with /TOP and /FOREGROUND. The optional type (DAS or INS) is vahd 
only with the /IDSPACE option. 

/BOUNDARY[:value[:type]] 

Links a specified program section starting at a specified address boundary; invalid 
with /TOP The optional type (DAS or INS) is valid only with the /IDSPACE option. 

/DEBUG[:filespec] 

Links a debugger (ODT, VDT, or user supplied) with your program. 

/DUPLICATE 

Allows multiple copies of a library or module. 

/EXECUTE[:filespec] 

Specifies a name for the LINK output file; the output file name defaults to the input 
file name. 

/NOEXECUTE[:filespec] 

Suppresses the creation of an output file. 

/EXTEND:value[:type] 

Extends a program section to a specific octal value. The optional type (DAS or INS) 
is valid only with the /IDSPACE option. 

/FILL :value[:type] 

Initializes unused locations in the load module and places a specific octal value in 
those locations. The optional type (DAS or INS) is valid only with the /IDSPACE 
option. 

/FOREGROUND[:stacksize] 

Produces an executable file in relocatable (REL) format for use as a foreground 
job under a multi-job monitor. The stacksize specifies the number of bytes of stack 
space to allocate for the foreground job. 



3-66 RT-11 Commands 



LINK 

/GLOBAL 

Generates a cross reference of all the global symbols in the load map. 

. LINK/GLOBAL/MAP : DUl : MYPROG 

When you specify a cross-reference listing with the /GLOBAL option, LINK 
generates the temporary file DK:CREF.TMP. The following command syntax 
designates a device for this temporary file: 

.ASSIGN dev: CF 

/IDSPACE 

Causes LINK to generate an extended SAV image file which separates I and D 
space. /IDSPACE and /FOREGROUND[:stacksize] are incompatible. 

/INCLUDE 

Lets you take global symbols from any library and include the object modules the 
symbols specify in the linked memory image. 

/LDA 

Links files in LDA format; invaUd with /FOREGROUND and /XM. 

/LIBRARY:filespec 

Same as /LINKLIBRARY. 

/LIMIT:value 

(Valid only with the RSTS/E operating system) 

/LINKLIBRARY:filespec 

Includes the library file you specify as an object-module library in the linking 
operation. 

/MAP[:filespec] 

Sends a load-map listing to the printer or to a filespec. The following command 
creates a map listing file called MYPROG.MAP on DUl: 

. LINK/MAP : DUl : MYPROG 

/PROMPT 

Allows multiple input lines. Terminate with two slashes (//). 

.LINK/PROMPT COSINE [RET[ 
*TAN/0 : 1 [RET] 
*C0S1/0:1 [ret] 
*SIN3/0:2 [RET] 
*LML3/0:2// [ret] 
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/ROUND:value[:type] 

Rounds the section size to a multiple of the value you specify; the value must be a 
power of 2. The optional type (DAS or INS) is valid only with the /IDSPACE option. 

/RUN 

Initiates execution of the resultant SAV file. Invalid with /FOREGROUND and 
/LDA. 

/SLOWLY 

Allows the largest possible LINK symbol table. 

/STACK[:value] 

Sets the stack address in location 42 to the value you specify. When specified with 
/IDSPACE, if value is not specified, the specified stack symbol is verified to be in 
D-space. 

/SYMBOLTABLE[:filespec] 

Creates a file containing definitions for all the global symbols in the load module. 
The following command creates the symbol-table file BTAN.STB: 

. LINK AOBJ, BOBJ/SYMBOLTABLE : BTAN 

/TOP:value[:type] 

Specifies the highest address to be used by the relocatable code in the load module; 
invalid with /BOTTOM and /FOREGROUND. The optional type (DAS or INS) is 
valid only with the /IDSPACE option. 

/TRANSFER[:value] 

Specifies the starting address for program execution. When specified with 
/IDSPACE, if value is not specified, the specified transfer symbol is verified to be in 
I-space. 

/WIDE 

Produces a wide load-map listing. 

/XM 

Enables special .SETTOP and .LIMIT features provided in a mapped monitor; 
invalid with /LDA. 
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LOAD 

(KMON) 

Copies a device handler from the system device into memory and assigns them to 
foreground, background, system jobs, or BATCH. 

LOAD device[=jobname][,...device[=jobnanne]] 

To assign a device handler for exclusive use by a program, specify the program 
name. For example, to assign the XL communication-port handler to VTCOM and 
to assign the LS serial-interface printer handler to SPOOL, do the following: 

LOAD XL=VTCOM 
LOAD LS=SPOOL 



MACRO 

(MACRO) 

Runs the MACRO assembler. 

MACRO filespec[s]) 

Command Options Input-File Options 

/CROSSREFERENCE[:type[:type...]] /LIBRARY 

/DISABLE:type[:type...] 

/ENABLE:type[:type...] 

/LIST[:filespec] 

/ALLOCATE :size 
/[NO]/OBJECT[:filespec] 

/ALLOCATE :size 
/[NO]SHOW:type[:type...] 

/ALLOCATE :size 

Reserves space for the output file; a size of -1 reserves the largest possible space. 

/CROSSREFERENCE[:type[:type...]] 

Produces a CREF listing; the types are as follows. 
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MACRO 



Type 



Meaning 



C 

E 

M 

P 

R 

S 

None 



Control sections (.CSECT symbolic names) 

Error codes 

Macro symbolic names 

Permanent symbols (instructions, directives) 

Register symbols 

User-defined symbols 

Equivalent to :S:M:E 



/DISABLE:type[:type...] 

Specifies a MACRO .DSABL directive; the types are as follows. 



Type 



Default 



What Is Enabled or Disabled 



ABS 


Disable 


AMA 


Disable 


CDR 


Disable 


DBG 


Disable 



FPT 


Disable 


GBL 


Enable 


LC 


Enable 


LCM 


Disable 


LSB 


Disable 


PNC 


Enable 


REG 


Enable 



Absolute binary output 

Assembly of all absolute addresses as relative addresses 

Treating source columns 73 and greater as comments 

Generation of internal symbol directory (ISD) records 
during assembly (See Chapter 2 of the RT-11 Volume 
and File Formats Manual for more information on ISD 
records.) 

Floating-point truncation 

Treating undefined symbols as globals 

Accepting lowercase ASCII input 

Uppercase and lowercase sensitivity of MACRO-11 
conditional assembly directives .IF IDN and .IF DIF 

Local symbol block 

Binary output 

Mnemonic definitions of registers 



/ENABLE:type[:type...] 

Specifies a MACRO .ENABL directive; types are listed under /DISABLE. 
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MACRO 



/LIBRARY 

Identifies the file it qualifies as a library file. The following command includes two 
user libraries (MYLIBl.MLB and MYLIB2.MLB): 

. MACRO MYLIB1/LIBRARY+A+MYLIB2/LIBRARY+B 

/LIST[:filespec] 

Produces a MACRO assembly listing on the printer or in the specified filespec. 

.MACRO/LIST MYPROG 

/[NO]OBJECT[:filespec] 

[Does not] generate an .OBJ file; the output file name defaults to the input file 
name. 

/[NO]SHOW:type[:type...] 

Specifies MACRO [.NLIST] and .LIST directives; the types are as follows. 



Type 



Default 



Controls 



BEX 


List 


BIN 


List 


CND 


List 


COM 


List 


LD 


Nolist 


LOG 


List 


MC 


List 


MD 


List 


ME 


Nolist 


MEB 


Nolist 


SEQ 


List 


SRC 


List 


SYM 


List 


TOC 


List 


TTM 


Line printer 



Extended binary code 

Generated binary code 

Unsatisfied conditionals, .IF and .ENDG statements 

Comments 

Listing directives with no arguments 

Location counter 

Macro calls, repeat range expansions 

Macro definitions, repeat range expansions 

Macro expansions 

Macro expansion binary code 

Source line sequence numbers 

Source code 

Symbol table 

Table of contents 

Wide or narrow listing format 
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MOUNT 

(LD) 



Associates the logical-disk unit (LDn) you specify with the file you specify and 
optionally assigns it a logical name. This enables you to use a logical disk as if it 
were a physical disk. 

MOUNT logical-disk-unit filespec [logical-device-name] 

Command Options 

/READONLY 
/[NOIWRITE 

The MOUNT command associates a logical-disk file with one of eight logical-disk 
units (LD0-LD7). If you perform a system generation (SYSGEN), and request 
extended device-unit support, you can access up to 32 logical-disk units at one time. 

The following command example associates logical-disk unit 5 (LD5) with the file 
DATA.DSK on device DUl: 

.MOUNT LD5: DUl: DATA 

/READONLY 

Does not allow WRITE access through LD to any files contained in the specified 
logical-disk unit. 



/[NOJWRITE 

[Does not] make the logical disk write enabled. 
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PRINT 

(PIP, QUEMAN, QUEUE, and SPOOL) 

Sends the contents of one or more files to the printer. 

PRINT filespec[s] 



Command Options 



/BEFORE[:date] 

/SINCE[:date] 
/DATE[:date] 
/NEWFILES 
/COPIES:value 
/DELETE 

/[NOJFLAGPAGE :value 
/INFORMATION 
/[NOJLOG 

/NAME : [dev:lj obname 
/OUTPUT:dev:[filespec] 
/PRINTER 
/PROMPT 
/QUERY 
/WAIT 



/BEFORE[:date] 

Prints only those files created before the specified date. The following command 
prints all MAC files on DUO: created before April 21, 1991: 

. PRINT/BEFORE : 21 : APR ; 91 DUO : * . MAC 

/COPIES.value 

Prints the specified number of files; the valid range is from 1 to 32. 

.PRINT/COPIES: 3 REPORT 

/DATE[:date] 

Prints only those files with the specified creation date. 

.PRINT /DATE: 21 -.RPR -.91 DK:*.MAC 
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PRINT 

/DELETE 

Deletes a file after it is printed. 

. PRINT/DELETE DUl : PROGl . BAS 

/[NOJFLAGPAGE lvalue 

(Valid only with SPOOL or QUEUE) [Does not] include the specified number of 
banner pages at the start of a file. The following example prints three banner pages 
for each file given: 

. PRINT /FLAGPAGE : 3 PROGl . MAC, PROGl . LST, PROGl . STB 

/INFORMATION 

Displays informational rather than fatal messages for file not found and prints all 
others. 

.PRINT/INFORMATION DLO : (FILEl, FILE2, FILE3) .TXT 
?PIP-I-File not found DLO :FILE2 .TXT 

/[NOJLOG 

[Does not] log file names on the terminal as they are printed. 

. PRINT/LOG/DELETE REPORT 
Files copied/deleted: 
DK : REPORT . LST to LP: 

/NAME:[dev:]jobname 

Specifies a job name for the files you want printed; with dev, send files to that 
device. 

.PRINT/NAME:DU1:J0B5 FILEl, FILE2, FILE3 

/NEWFILES 

Prints only those files that have the current system date. 

.PRINT /NEWFILES * 
Files copied: 
DK:OUTFIL.LST to LP: 
DK : REPORT . LST to LP: 

/OUTPUT:dev:[filespec] 

Specifies the output device for the PRINT command. 

/PRINTER 

Forces files to be copied directly to the printer if QUEUE is running. 
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/PROMPT 

(Valid only with QUEUE) Allows multiple input lines; terminated with a double 
slash (//). 

.PRINT/PROMPT FILEl 
*FILE2, FILE3 
*FILE4 
*FILE5// 

/QUERY 

Asks if specific files should be printed. 

.PRINT/QUERY * . LST 
Files copied: 
DK : OUTFIL .LST to LP:? N 
DK: REPORT. LST to LP:? Y 

/SINCE[:date] 

Prints only those files created on or after the specified date. The following command 
prints all MAC files on DUO created on or after April 21, 1991: 

. PRINT/SINCE : 21 : APR : 91 DUO:*. MAC 

/WAIT 

(Invalid with QUEUE) Waits for the volume to be mounted before executing the 
command. 
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PROTECT 

(PIP) 

Protects a file so that you cannot delete it until you remove the protection. 

PROTECT filespec[s] 
Command Options 

■ /BEFORE[:date] 
. /SINCE[:date] 

/DATE[:date] 

/NEWFILES 
/EXCLUDE 
/INFORMATION 
/[NOJLOG 
/QUERY 
/SETDATE[:date] 
/SYSTEM 
/WAIT 



/BEFORE[:date] 

Protects only those files created before the specified date. The following command 
protects all MAC files on DK created before March 20, 1991: 

. PROTECT /BEFORE :20: MAR : 91 *. MAC 

Files protected: 

DK-.A.MAC 

DK: B.MAC 

DK:C.MAC 

/DATE[:date] 

Protects only those files with the specified creation date. The following command 
protects all MAC files on DK that were created on March 20, 1991: 

.PROTECT/DATE:20:MAR:91 * .MAC 
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PROTECT 

/EXCLUDE 

Protects all the files on a device except the ones you specify. The following command 
protects all files on DUl except SAV files and SYS files: 

. PROTECT /EXCLUDE DUl : * . SAV 

?PIP-W-No .SYS action 

Files protected: 

DUl: ABC. OLD 

DU1:AAF.0LD 

DUl : COMB . 

DUl: MERGE. OLD 

/INFORMATION 

Displays informational rather than fatal messages for file not found and protects 
all others. 

.PROTECT /INFORMATION DLO : (FILEl, FILE2, FILE3) .TXT 
?PIP-I-File not found DLO :FILE2 .TXT 

/[NOJLOG 

[Does not] list on the terminal all the files protected by the current command. 

/NEWFILES 

Protects only the files having the current system date. 

. PROTECT /NEWFILES DUl : * . BAK 
Files protected: 
DUl: MERGE. BAK 

/QUERY 

Ask for confirmation before protecting each file. The following example shows 
querying. Only the file DU1:AAF.MAC is protected: 

. PROTECT/QUERY DUl :*.* 
Files protected: 
DUl: ABC. MAC ? N 
DU1:AAF.MAC ? Y 
DUl: MERGE. FOR ? N 

/SETDATE[:date] 

Assigns the specified date to all the newly protected files. The following example 
protects three files and changes their dates to the current system date: 

. PROTECT /SETDATE DUl : * . FOR 

Files protected: 

DUl: ABC. FOR 

DUl:AAF.FOR 

DUl: MERGE. FOR 
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/SINCE[:date] 

Protects only those files created on or after the specified date. The following 
command protects all MAC files on DUl that were created on or after April 21, 
1991: 

. PROTECT/SINCE : 21 : APR : 91 DUl:*. MAC 

/SYSTEM 

Protects any unspecified .SYS files in a wildcard operation. This example protects 
all files on DUl with the file name MM, including SYS files: 

.PROTECT/SYSTEM DUl: MM. * 

Files protected: 

DUl: MM. MAC 

DUl: MM. OB J 

DU1:MM.SAV 

DU1:MM.SYS 

/WAIT 

Waits for the volume to be mounted before executing the command. The following 
example protects the file FILE. MAC on an RL02 disk: 

. PROTECT /WAIT DL : FILE . MAC 
Mount input volume in DLO : ; Continue? Y 
Mount system volume in DLO:; Continue? Y 



(KMON) 

Loads and runs programs from the system device or from the specified file-structured 
device. See also FRUN, RUN, SRUN, and VA^RUN. 

R filespec 

Use the R command only with background jobs, including privileged jobs, under a 
mapped monitor. 
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REENTER 

(KMON) 

Starts the program at its reentry address (the start address minus 2). 

REENTER 



REMOVE 

(KMON) 

Removes a device name from the monitor's system tables and, under a mapped 
monitor, can be used to remove a global region. 

C xx:[,xx:...] 
REMOVE I yy[,yy...] 

\ region[,region...] 

where: 

xx: is a device name. 

yy is a device name or global region, (mapped monitors only) 

region is a l-to-6-character global region, (mapped monitors 

only) 

If you COPY or RENAME a handler, issue a REMOVE and an INSTALL after you 
change the handler to ensure the system uses the new version of the handler: 

.COPY SDH. SYS SD.SYS 
. UNLOAD SD 
.REMOVE SD 
.INSTALL SD 
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RENAME 

(PIP) 

Assigns a new name to an existing file. 

RENAME in-filespec[s] out-filespec 



Command Options 



/BEFORE[:date] 
/SINCE[:date] 

/DATE[:date] 

/NEWFILES 

/INFORMATION 

/[NO]LOG 

/[NOIPROTECTION 

/QUERY 

/[NOIREPLACE 

/SETDATE[:date] 

/SYSTEM 

A¥AIT 



/BEFORE[:date] 

Renames only those files created before the specified date. The following command 
renames all MAC files on DUl created before April 21, 1991: 

.RENAME/BEFORE: 21: APR: 91 DUl:*. MAC DU1:*.BAK 

/DATE[:date] 

Renames only those files with the specified creation date. The following command 
renames all MAC files created on March 20, 1991 to BAK files: 

. RENAME/DATE : 20 :MAR: 91 DK:*. MAC * . BAK 

/INFORMATION 

Displays an informational rather than a fatal message for files not found and 
renames all others. In the following example, the input files FILE1.TXT and 
FILE3.TXT are renamed. However, since RT-11 is unable to find DL0:FILE2.TXT, 
RT-11 displays a message to inform you: 

.RENAME /INFORMATION DLO : (FILEl, FILE2, FILE3) .TXT 
?PIP-I-File not found DL0:FILE2 .TXT 
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RENAME 

/[NO]LOG 

[Does not] list the renamed files on the terminal. 

.RENAME DUO: (A*. MAC *.FOR) 
Files renamed : 

DUO: ABC. MAC to DUO: ABC. FOR 

DUO:AAF.MAC to DU0:AAF.FOR 

/NEWFILES 

Renames only those files with the current system date. 

/[NOJPROTECTION 

[Does not] mark a file as protected. 

/QUERY 

Asks for confirmation before renaming a file. 

.RENAME/QUERY *.BAK *.MAC 
Files renamed: 
DK:PROGl.BAK to DK:PROGl.MAC ? Y 
DK:PR0G2.BAK to DK:PROG2.MAC ? Y 
DK:PROG6.BAK to DK:PROG6.MAC ? Y 
DK:LML8A.BAK to DK:LML8A.MAC ? 
DK:LML9 .BAK to DK:LML9 .MAC ? Y 

/[NOJREPLACE 

[Does not] replace an existing file having the same name. 

In the following example, the output file already existed and so nothing is renamed. 

. RENAME /NOREPLACE DUO : TEST . SAV DU0:DUP. SAV 

?PIP-W-Output file found, no operation performed DUO: TEST. SAV 

/SETDATE[:date] 

Assigns the specified date to all the renamed files. The following example renames 
the specified files and changes their dates to the current system date: 

. RENAME /SETD ATE DUl: (*. FOR * . OLD) 
Files renamed : 

DUl: ABC. FOR to DUl: ABC. OLD 

DUl : MERGE . FOR to DUl :MERGE .OLD 
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/SINCE[:date] 

Renames all files on or after a specified date. The following command renames only 
those MAC files on DK created on or after February 24, 1991: 

.RENAME/ SINCE: 24 -.FEB -.91 * .MAC *.BAK 
Files copied: 
DK:A.MAC to DK:A.BAK 
DK:B.MAC to DK:B.BAK 

/SYSTEM 

Includes SYS files in a wildcard RENAME operation. 

This example renames all files on DUl: with the file name MM, including SYS files, 
to MX files: 

.RENAME/SYSTEM DUl :MM. * DUl :MX. * 
Files renamed: 
DU1:MM.MAC to DU1:MX.MAC 
DUl:MM.OBJ to DUl:MX.OBJ 
DU1:MM.SAV to DU1:MX.SAV 
DU1:MM.SYS to DU1:MX.SYS 

/WAIT 

Waits for the volume to be mounted before executing the command. 

.RENAME /WAIT /NOLOG SY: (PRIAM.TXT NESTOR.TXT) 
Mount input volume in DUO:; Continue? Y 
Mount system volume in DUO:; Continue? Y 



RESET 

(KMON) 

Initializes several background system tables and does a general cleanup of the 
background area. 

RESET 

Use RESET before you execute a program if a device or the monitor needs 
reinitialization The following example uses the RESET command before running a 
program: 

.RESET 
.R MYPROG 
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RESUME 

(KMON) 

Continues execution of a foreground or system job from the point at which a 
SUSPEND command was issued. 

RESUME [jobname] 

The following command resumes execution of the suspended foreground job: 

.RESUME 

The next command resumes execution of the suspended system job, QUEUE. SYS: 

.RESUME QUEUE 

You can also use RESUME to start a job loaded with FRUN or SRUN using 
/PAUSE. 

RUN 

(KMON) 

Loads and runs a program from the default device DK, or from the specifed 
file-structured device. See also FRUN, R, SRUN, and VA^RUN. 



RUN filespec 

where: 

filespec 
argument 

input-list 

output-list 



input-list, [output-list] 
argument 



specifies a SAV executable file. 

specifies a single CSI argument to be passed to the 
program. 

specifies a list of CSI or CCL input file specifications to be 
passed to the program. 

specifies a list of CSI or CCL output file specifications to 
be passed to the program. 
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Examples: 

1. RUN executes the program MYPROG.SAV: 

.RUN DU1:MYPR0G 

2. DUl:*.* is the input and LP:/E is the output: 
. RUN DIR DUl :*.* LP: /E 

3. An alphabetical directory listing is displayed on the terminal: 

.RUN DIR /A 

SAVE 

(KMON) 

Writes selected areas of memory to a file. 

SAVE filespec address[-address(2)][,address(3)[-address(n)]] 

RT-11 transfers memory in 256-word blocks, beginning on boundaries that are 
multiples of 256io. 

The following command saves the contents of locations 10000 through 11777 and 
14000 through 14777 and stores them in FILEl.SAV: 

.SAVE FILEl 10000-11000, 14000-14100 

SET CLI 

(KMON) 

Enables or disables one or more command-line interpreters. 

SET CLI interpreter1,interpreter2,... 

Command Summary 



SET CLI 



[NO]CCL 
[NO]DCL 
[NO]UCF 

[NO]UCL 
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SET CLOCK 

(KMON) 

Sets the frequency of the system clock. 

SET CLOCK frequency 

50 

Causes the system to use a 50-Hz line frequency clock rate. 

60 

Causes the system to use a 60-Hz line frequency clock rate (the default). 

SETDL 

(DL) 

Sets the DL disk handler (RL01/RL02 disks). 

SET DL condition 

CSR=n 

Uses n as the CSR address for the DL handler. 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the DL handler. 
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SET DM 

(DM) 

Sets the DM disk handler (RK06/RK07 disks). 

SET DM condition 

CSR=n 

Uses n as the CSR address for the DM handler. 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the DM handler. 

SETDU 

(DU) 

Sets the DU device handler (MSCP disks and diskettes). 

SET DU condition 

CSR=n 

Uses n as the CSR address for the first port of the DU MSCP controller. 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the first port of the DU MSCP controller. 
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SET DUx 

(DU) 

Defines how an MSCP disk is partitioned. 

SET DUx condition 

CSRy=n 

(Valid only if the handler is assembled for multiple ports) Modifies the DU handler 
to use n as the CSR address for DU controller y. The y can be from to 3, with 
being the default. SET CSRO=n is equivalent to SET CSR=n. 

PART=n 

Defines the partition of a disk on which device unit x resides. The n can be from 
to 255, depending on the size of the disk device (each partition is 64K blocks). The 
default for n is 0. 

SET DUx PART-n assigns DUx to disk partition n. 

PORT=n 

Assigns DUx to MSCP port n. The x can be from to 7, with being the default. 

With extended-unit support, x can be from to 64io- Specify an extended DU device 
unit in the format Dxx, where xx is a number from through VTg. 

The n (specifying the port) can be from to 3, with being the default. 

UNIT=n 

Assigns DUx to MSCP unit n. The n can be from to 251. By default, n equals x. 

VECy=n 

(Valid only if the handler is assembled for multiple ports) Modifies the DU handler 
to use n as the vector address for controller y. The y can be from to 3, with 
being the default. SET DU VECO=n is equivalent to SET DU VECTOR=n. 
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SETDW 

(DW) 

Sets the DW disk handler (RDxx disks). 

SET DW condition 

RETRY=n 

Sets the number of retries after an I/O error. 

SLOT=n 

(Valid only with the PRO Expander) Assigns a copy of the DW handler to the 
controller for the description for an explanation of how to do this. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

[NO]WCHECK 

WCHECK verifies output to DW disks by reading data after writing it to the disk. 
NOWCHECK does not verify output to DW disks. 

[NOJWRITE 

WRITE write enables DW disk drive unit 0. NOWRITE write locks DW disk drive 
unit 0. 
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SETDX 

(DX) 

Sets the DX diskette handler (RXOl diskettes). 

SET DX condition 

CSR=n 

Uses n as the CSR address for the DX handler. 

CSR2=n 

(Valid only with support for a second controller) Uses n as the CSR address for the 
DX handler. 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the DX handler. 

VEC2=n 

(Valid only with support for a second controller) Uses n as the vector address for 
the DX handler. 



SET DXx 

(DX) 

Sets the specified unit of the DX diskette handler (RXOl diskettes). 

SET DXx condition 

[NOJWRITE 

WRITE, the default, write enables DX unit x. NOWRITE write locks DX unit x. 
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SETDY 

(DY) 

Sets the DY diskette handler (RX02 diskettes). 

SET DY condition 

CSR=n 

Uses n as the CSR address for the DY handler. 

CSR2=n 

(Valid only with support for a second controller) Uses n as the CSR address for the 
DY handler. 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the DY handler. 

VEC2=n 

(Valid only with support for a second controller) Uses n as the vector address for 
the DY handler. 



SET DYx 

(DY) 

Sets the specified unit of the DY diskette handler (RX02 diskettes). 

SET DYx condition 

[NOJWRITE 

WRITE, the default, write enables DY unit x. NOWRITE write locks DY unit x. 
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SETDZ 

(DZ) 

Sets the DZ diskette handler (RX50 diskettes for Professional 300 series). 

SET DZ condition 

RETRY=n 

Sets the number of retries after an I/O error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

SET EDIT 

(KMON) 

Defines an editor as the default editor. 

SET EDIT default-editor) 

EDIT 

is EDIT.SAV. 

KED 

is KED.SAV (default with distributed unmapped monitors) 

KEX 

is KEX.SAV (default with distributed mapped monitors) 

TECO 

is TECO.SAV (TECO is not distributed or supported by Digital.) 
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SET EL 

(KMON) 

Sets the Error Logger for single-job monitors. 

SET EL condition 

[NOJLOG 

LOG turns on error logging. 

NOLOG, the default, turns off error logging. 

PURGE 

Clears the internal error-log buffer in a single-job monitor. 

SET EL 

(KMON) 

Sets the Error Logger for single-job monitors. 

SET EL condition 

[NOJLOG 

LOG turns on error logging. 

NOLOG, the default, turns off error logging. 

PURGE 

Clears the internal error-log buffer in a single-job monitor. 
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SET ERROR 

(KMON) 

Controls the level of failure that aborts a command file. 

SET ERROR condition 

ERROR 

(the default) Aborts command files if error, fatal, or unconditional errors occur. 

FATAL 

Aborts command files if fatal or unconditional errors occur. 

NONE 

Continues processing. 

UNCONDITIONAL 

Aborts command files if an unconditional error occurs. 

WARNING 

Aborts command files if warning, error, fatal, or unconditional errors occur. 

SET EXIT 

(KMON) 

Selects whether or not SWAP.SYS is used on job exit. 

SET EXIT condition 

[NOJSWAP 

SWAP, the default, saves the running program in the swap blocks when the program 
exits so that it can be restarted with the REENTER command. 

NOSWAP disables the writing of a program to the swap blocks when the program 
exits. 
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SET FORTRA 

(KMON) 

Sets the default FORTRAN compiler. 

SET FORTRA compiler 

F4 

(the default) Causes the FORTRAN IV compiler to be called by the COMPILE 
/FORTRAN, EXECUTE/FORTRAN, and FORTRAN commands. 

F77 

Causes the FORTRAN-77 compiler to be called by the COMPILE/FORTRAN, 
EXECUTE/FORTRAN, and FORTRAN commands. 

SET KMON 

(KMON) 

Sets KMON to recognize IND (INDirect control-file processor) control files. 

SET KMON condition 

[NOJIND 

IND causes IND.SAV to interpret the expression @filespec as a control file to be 
executed. NOIND, the default, causes KMON to interpret the expression ©filespec 
as a command file to be executed. 

The syntax $@filespec forces NOIND interpretation even when SET IND is in effect. 
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SETLD 

(LD) 

Sets the logical-disk subsetting handler. 

SET LD condition 

CLEAN 

Checks all logical-disk assignments to make sure they are valid. 

EMPTY 

Dismounts all logical-disk assignments. 



SET LDx 

SET LDx condition 

[NOJWRITE 

(Used during disk subsetting) WRITE, the default, defines logical-disk unit x as 
being write enabled (read/write access allowed). The x can be from to 7. With 
extended-unit support, x can be from to 328- The syntax for specifying an 
extended device unit is Lxx: 

NOWRITE, used during disk subsetting, defines logical-disk unit x as being write 
locked (read-only access allowed). 



SET LP 

(LP) 

Sets the line-printer handler. 

SET LP condition 

[NOJBIT8 

BITS passes the eighth bit unaltered. 

N0BIT8, the default, forces the eighth bit to zero. 

[NO]CR 

CR sends carriage return characters (octal 15) to the line printer. 



RT-11 Commands 3-95 



SET LP 

NOCR, the default, does not send carriage return characters (octal 15) to the line 
printer. 

CSR=n 

Usees n as the CSR address for the LP handler. 

[NOJCTRL 

CTRL passes all characters, including nonprinting control characters, to the printer. 

NOCTRL, the default, ignores nonprinting control characters. 

ENDPAG=n 

Appends n form feeds at the end of the file. The default is 0. 

[NO]FORM 

FORM, the default, uses the form-feed character (octal 14) to generate form feeds. 

[NOJFORMO 

FORMO, the default, issues a form feed before printing block 0. 

NOFORMO does not issue a form feed before printing block 0. 

[NO]HANG 

HANG, the default, waits for you to make a correction when the line printer is not 
ready. 

NOHANG generates an immediate error when the line printer is not ready. 
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[NOJLC 

Sends lowercase characters to the printer. 

NOLC, the default, translates characters in lowercase to uppercase before printing. 

LENGTH=n 

Defines the length of page by the number of lines. The default length is 66 lines. 

SKIP=n 

Defines the number of lines to skip at page break; use with SET LP NOFORM. The 
default is SKIP=0. 

[NO]TAB 

TAB sends TAB characters to the line printer. 

NOTAB, the default, expands TAB characters by sending multiple spaces to the 
line printer. 

VECTOR=n 

Uses n as the vector of the line printer controller. 

WIDTH=n 

Sets the line width to n, where n can be from 30io to 255io. The default is 132. 



SETLS 

(LS) 

Sets the serial-printer handler. 

SET LS condition 

[NO]BIT8 

Passes the eighth bit unaltered. 

N0BIT8, the default, forces the eighth bit to zero. 

[NO]CR 

CR, the default, sends carriage-return characters (octal 15) to the printer. 

NOCK does not send carriage-return characters (octal 15) to the printer. 

CSR=n 

Uses n as the CSR address for the LS handler. 
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SETLS 

[NOJCTRL 

CTRL, the default, passes all characters, including nonprinting control characters, 
to the printer. 

NOCTRL ignores nonprinting control characters. 

ENDPAG=n 

Appends n number of form feeds at the end of each file. The default is 0. 

[NOJFORM 

FORM, the default, uses the form-feed character (octal 14) to generate form feeds. 

NOFORM use multiple line-feed characters to simulate form feeds. 

[NOJFORMO 

FORMO, the default, issues a form feed before printing block 0. 

NOFORMO does not issue a form feed before printing block 0. 

[NO]GRAPH 

GRAPH sets the LS handler to output all characters regardless of the width of the 
line. 

NOGRAPH, the default, sets the LS handler to not print any characters that do not 
fit on a line. 

[NOJHANG 

HANG, the default, waits for you to make a correction when the printer is not 
ready. 

NOHANG generates an immediate error when the printer is not ready. 

[NO]LC 

LC, the default, sends lowercase characters to the printer. 

NOLO translates lowercase characters to uppercase before printing. 

LENGTH=n 

Defines length of page; the initial value of n is 66 lines. 

LINE=n 

(With multiterminal support only) Modifies the serial-printer handler to use line n 
of a multiterminal monitor as the serial port. 

[NOJMTTY 

(With multiterminal support only) MTTY selects use of multiterminal as the 
interface to the serial printer. NOMTTY selects use of a DL interface for which it 
was built as the interface to the serial printer. 
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SKIP=n 

Defines the number of lines to skip at page break; use with SET LIS NOFORM. 
The default is SKIP=0. 

SPEED=n 

(Valid for a Professional 300 series computer only) Sets the printer to run at baud 
n, where n can be any of the following baud rates: 

50 1200 

75 1800 

110 2000 

134 2400 

150 3600 

200 4800 

300 9600 

600 19200 

[NOJTAB 

TAB sends TAB characters (octal 11) to the printer. 

NOTAB, the default, simulates tabs with spaces. 

VECTOR=n 

Uses n as the vector address of the LS handler. 

WIDTH=n 

Sets the line width to n, where « is a decimal integer between 30 and 255 inclusive. 
The initial value of n is 132. 



SET MODE 

(KMON) 

Sets or clears the obsolete FBMON$ bit in the configuration offset of the monitor 
fixed area to indicate the obsolete SJ monitor characteristics. 

SET MODE [NO]SJ 

[NO]SJ 

SET MODE SJ turns the FBMON$ bit off 

SET MODE NOSJ, the default, turns the FBMON$ bit on. 
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SET MM 

(MM) 

Sets the MM magtape handler (TJU16/TJE16/TU45/TJU77 magtapes). 

SET MM condition 

CSR=n 

Uses n as the CSR address for the MM handler. 

DEFALT=9 

Sets the default settings for 9-track magtape. The 9-track defaults are: 

DENSE=809 
ODDPAR 

DENSE=density 

Sets density for the 9-track tape handler. The density can be: 

800 (or 809) bpi 
1600 bpi 

[NO]ODDPAR 

ODDPAR, the default, sets parity to odd for 9-track tape. 

NOODDPAR sets parity to even for 9-track tape. 

RETRY=n 

Specifies the number of times the device handler attempts to recover from an I/O 
error. 

VECTOR=n 

Uses n as the vector address for the MM handler. 



SET MS 

(MS) 

Sets the MS magtape handler (TK25/TS11/TSV05/TSU05/TU80 magtapes). 

SET MS condition 
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CSR=n 

Uses n as the CSR address for the first controller. SET CSR=n is equivalent to 
SET CSRl^n. 

CSRx=n 

(Valid only with multiple ports) Uses n as the CSR address for MS controller x; x 
can be from 2 to 8. 

RETRY=n 

Specifies the number of times the device handler attempts to recover from an I/O 
error. 

VECTOR=n 

Uses n as the vector address for the first controller. SET MS VECTOR=n is 
equivalent to SET MS VECl=n. 

VECx=n 

(Valid only with multiple ports) Uses n as the vector address for controller x; x can 
be from 2 to 8. 



SETMT 

(MT) 

Sets the MT magtape handler (TM11/TMA11/TS03/TE16 magtapes). 

SET MT condition 

CSR=n 

Uses n as the CSR address for the MT handler. 

DEFALT=n 

Sets defaults for 7- or 9-track magtape; n can be 7 or 9. 

DENSE=n 

Sets density for 7- or 9-track magtape; n can be 200, 556, 800, 807, or 809 bpi. 

DUMP 

Writes bytes to 7-track magtape at 800 bpi. 

[NOJODDPAR 

ODDPAR, the default, sets odd parity for 7- or 9-track magtape. 

NOODDPAR sets even parity for 7- or 9-track magtape. 
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RETRY=n 

Specifies the number of times the device handler attempts to recover from an I/O 
error. 

VECTOR=n 

Uses n as the vector address for the MT handler. 



SETMU 

(MU) 

Sets the MU magtape handler (TMSCP magtape devices). 

SET MU condition 

CSR=n 

Uses n as the CSR address for the first controller. 

RETRY=n 

Specifies n as the number of times MU attempts to recover from an error. 

[NOJSUCCES 

(Valid only with error-logging support) SUCCES, the default, modifies the MU 
handler to log successful I/O transfers as well as errors when the Error Logger is 
running. 

NOSUCCES, the default, modifies the MU handler to not log successful I/O 
transfers as well as errors when the Error Logger is running. 

VECTOR=n 

Uses n as the vector for the first controller. 



SET MUX 

(MU) 

Sets the specified unit of the MU magtape handler (TMSCP magtape devices). 

SET MUx condition 
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CSRy=n 

(Valid only if you sysgen the specified MU controller handler) Modifies the MU 
device unit y to use n as the CSR address for a controller, y can be 0, 1, 2, or 3. 
SET MU CSRO=n is the same as SET MU CSR^n. 

DEFALT 

Returns magtape unit n to the default density of 6250 bpi. Valid only with 9-track 
TMSCP magtapes and sets only the specified magtape unit. 

DENSE=n 

Sets density for only 9-track TMSCP magtapes and for only the specified magtape 
unit, n can be 1600 or 6250. Setting DENSE=1600 specifies 1600 bpi (phase 
encoded). Setting DENSE=6250 specifies 6250 bpi (group code recording). 

PORT=n 

(Valid only if the handler is assembled for multiple ports) Defines which port to 
access when magtape unit x is specified. The n can be from to 3 and corresponds 
to the variable y used with the SET MU CSRy=n and SET MU VECy=n commands. 
By default, the port variable n is the same as the magtape unit x. 

UNIT=n 

Defines which TMSCP unit number to access when magtape unit x is specified. The 
variable n can be from to 255; the default is 0. 

VECy=n 

(Valid only if you sysgen the specified MU controller handler) Modifies the MU 
device unit y to use n as the vector for a controller, y can be 0, 1, 2, or 3. SET MU 
VECTOR=n is the same as SET MU VECO=n. 



SETNC 

(NO 

Sets the Ethernet handler for the Professional 300 series processor. 

SET NC condition 

SHOW 

Displays the station physical address for the DECNA controller. 
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SETNL 

(NL) 

Sets the NULL handler. 

SET NL condition 

[NOJSYSGEN 

SYSGEN causes NL to match the current monitor's SYSGEN parameters. 

NOSYSGEN inhibits NL from instaUing under the current monitor. 

[NOJTOY 

SET NL TOY, the default, runs the NL handler installation code. This code 
transfers date and time information from the KDJll-E Time-Of-Year (TOY) clock 
to the resident monitor. 

SET NL NOTOY prevents the NL handler from transferring the current date and 
time to the resident monitor. 
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SETNQ 

(NQ) 

Sets the Ethernet handler for Q-bus processors. 

SET NQ condition 

CSR=n 

Uses « as a CSR address for the DEQNA or DELQA controller. 

SHOW 

Displays the station physical address for the DEQNA or DELQA controller. 

VECTOR=n 

Uses « as a vector address for the DEQNA or DELQA controller. 

SETNU 

(NU) 

Sets the Ethernet handler for UNIBUS processors. 

SET NU condition 

CSR=n 

Uses n as the CSR address. 

SHOW 

Displays the station physical address for the DEUNA or DELQA controller and also 
identifies the controller type. 

VECTOR=n 

Uses n as the vector address. 
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SETRK 

(RK) 

Sets the RK device handler (RK05 devices). 

SET RK condition 

CSR=n 

Uses n as the CSR address for the RK handler. 

RETRY=n 

Specifies the number of times the device handler attempts to recover from an I/O 
error. 

[NOJSUCCES 

SUCCES, the default, logs successful I/O transfers as well as errors when running 
the Error Logger. NOSUCCES logs only I/O errors. 

VECTOR=n 

Uses n as the vector address for the RK handler. 

SET RUN 

(VBGEXE) 

Enables or disables VBGEXE (the virtual run utility) to automatically load and 
execute programs in a completely virtual environment. See also V/VRUN. 

SET RUN condition 

[NO]VBGEXE 

VBGEXE enables VBGEXE to automatically load and execute programs under 
extended-memory monitors. 

NOVBGEXE disables VBGEXE to automatically run programs. 
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SETSD 

(SD) 

Configures the DBG-11 SD handler. 

SET SD condition 

See the DBG-11 Symbolic Debugger User's Guide for the hsting and description of 
the SET SD commands. 

SETSL 

(SL) 

Sets the single-line (SL) command editor. 

SET SL condition 

ASK 

Automatically checks for the type of terminal. 

[NOIKED 

KED turns on keypad editing functionality. 

NOKED, the default, turns off keypad editing. 

KMON 

Enables use of SL by KMON but not by user programs. 

[NOJLEARN 

LEARN leaves help text on the screen and scrolls input below it. 

NOLEARN, the default, does not keep help text on the screen. 

OFF 

Disables the single-line editor. This is the default. 

ON 

Enables the single-line editor for use both by KMON and by user programs and 
loads the SL handler. 
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[NOJLET 

LET lets you define a character or a program function key to substitute for a 
command string. 

NOLET, the default, disables the LET utility 

[NO]RECALL 

(only with mapped monitors) RECALL lets you use the RECALL command to recall 
previously entered commands. 

SET NORECALL, the default, disables the use of the RECALL command. 

[NOJSYSGEN 

SYSGEN configures the SL handler to match the current monitor's SYSGEN 
parameters. 

NOSYSGEN inhibits SL from installing under the current monitor. 

[NOJTTYIN 

TTYIN enables single-line editing of .TTYIN input. 

NOTTYIN disables single-hne editing of .TTYIN input. 

VTxxx 

Configures the SL handler to use the type of terminal you specify (VTIOO or VT102). 

WIDTH=n 

Sets the line width of the display to n number of characters, n can be from 30 to 
132io; the initial value of tz is 79. 



SETSP 

(SP) 

Sets the spool handler. 

SET SP condition 

EXIT 

EXIT stops SPOOL in a synchronous manner. Use SET SP EXIT to stop SPOOL 
from within a command file so that the monitor prompt is not returned until all 
SPOOL activity is terminated. 
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SET SPx 

(SP) 

Sets the spool handler for the specified device or for all spooled devices if no device 
is specified. 

SET SPx condition 

ENDPAG=n 

Appends n form feeds at the end of each file sent to spooled device x. 

ENDPAG=0 does not append form feeds at the end of a file. 

FLAG=n 

Specifies the number of flag pages to be prefixed to each file sent to spooled device 

X. 

[NOJFORMO 

FORMO issues a form feed on spooled device x each time SPOOL encounters block 
of a file to be printed. 

NOFORMO, the default, turns off FORMO mode for spooled device x. 

KILL 

Aborts output to the x spooled device. 

NEXT 

Stops printing the current file on spooled device x and proceeds to the next file 
queued to that device. 

[NOJWAIT 

WAIT interrupts output to spooled device x, while output to any other spooled 
device continues. 

NOWAIT resumes sending spooled output to device x after output to that device 
has been interrupted. 

[NOJWIDE 

WIDE causes SPOOL to generate 132-column flag pages for specified device x. 

NOWIDE causes SPOOL to generate 80-column flag pages for specified device x. 
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SET ST 

(ST) 



Makes the SYSGEN configuration bits of the ST handler compatible with the 
currently running monitor. 

SET ST SYSGEN 



SET TT (TERMINAL) 

(TT) 

Sets the terminal handler. SET TERMINAL can be substituted for SET TT. 

SET TT condition 

CONSOL=n 

(Requires multiterminal support) Changes the background console terminal to the 
terminal defined as logical terminal n. 

[NOJCRLF 

(Valid for multi-job monitors only) CRLF, the default, inserts a RETURN/LINE 
FEED when you attempt to type past the right margin. 

NOCRLF takes no special action at the right margin. 

[NOJFB 

(Valid for multi-job monitors only) FB, the default, treats | ctrl/b | and | ctrl/f | (and 
I cTRL/x I in monitors that include system job support) as program control characters. 

NOFB assigns no special meaning to | ctrl/b | , | ctrl/f | , and |ctrl/x| . 

[NOJFORM 

(Valid for multi-job monitors only) FORM indicates that the console terminal has 
hardware form feed capability. 

NOFORM, the default, simulates form feeds with eight line feeds. 

[NOJPAGE 

(Valid for multi-job monitors only) PAGE, the default, interprets | ctrl/s | as XOFF 
and I CTRL/Q I as XON to stop and start terminal output, respectively. 

NOPAGE causes | ctrl/s | and | ctruq | to have no special meaning. 
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[NOJQUIET 

QUIET disables the echoing of hnes from command files. 

NOQUIET, the default, enables echoing of command files as they are processed. 

[NOJSCOPE 

SCOPE, the default, echoes RUBOUT characters as backspace-space-backspace. 

NOSCOPE echoes RUBOUT characters by enclosing the deleted characters in 
backslashes. 

[NOJTAB 

(Valid for multi-job monitors only) TAB indicates that the console terminal has 
hardware tab stops. 

NOTAB, the default, simulates tab stops every eight positions. 

WIDTH=n 

(Valid for multi-job monitors only) Sets the terminal width to n, where n is an 
integer between 30 and 255io; the initial value of n is 80. 



SETUB 

(UB) 

Sets the UB handler that supports UNIBUS mapping registers (UMR) hardware in 
UNIBUS processors. 

SET UB condition 

[NOJINSTAL 

INSTAL, the default, allows installation of the UB handler with vahd UNIBUS 
configurations. 

NOINSTAL prevents installation of the UB handler with valid UNIBUS 
configurations. 

PERM=decimal-value 

Sets the number of permanent UMRs to reserve for handlers that are not installed 
during the boot process. 

[NO]SERIAL=octal-value 

SERIAL=octal-value forces serial satisfaction of outstanding I/O requests for the 
specified job, where octal-value is the job number. 
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NOSERIAL=octal-value, the default, satisfies outstanding I/O requests for the 
specified job, where octal-value is the job number, as required UMRs are free. I/O 
requests are satisfied as quickly as possible and not necessarily in serial order. 



SET USR 

(KMON) 

Sets the state of USR (User Service Routine) swapping. 

SET USR condition 

[NOJSWAP 

SWAP, the default, allows the background job to swap the USR. This setting is not 
valid for mapped monitors, but is the default mode for unmapped monitors. 

NOSWAP locks the USR in memory so that it cannot be swapped. 

SET VM 

(VM) 

Sets the VM (Virtual Memory) handler. 

SET VM condition 

BASE=nnnnnn 

Lets you select the location in memory where block of a virtual disk will begin 
(the base address). The VM handler uses memory at and above nnnnnn, a physical 
address multiplied by lOOg. 

[NOJINSTAL 

INSTAL, the default, causes the VM handler to install at the system boot. 

NOINSTAL causes an otherwise valid VM handler to not install at the system boot. 

SIZE=nnnnnn 

Lets you select the memory size in blocks (512 bytes for each block) of the virtual 
device. If you SET VM SIZE=0, VM allocates all available memory from the SET 
VM BASE value to the top of physical memory VM SIZE=0 is the default. 
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SET WILD 

(KMON) 

Sets the monitor to recognize wildcards in file specifications. 

SET WILD condition 

EXPLICIT 

The system recognizes file specifications exactly as typed. 

IMPLICIT 

The system fills in missing fields in file specifications with wildcards (asterisks). 
This is the default. 

SETXC 

(XC) 

Sets the baud rate of the communication-port handler for Professional 300 series 
processor. 

SET XC condition 

SPEED=n 

Sets the communication port to run at baud n, where n can be: 



50 


1200 


75 


1800 


110 


2000 


134 


2400 


150 


3600 


200 


4800 


300 


9600 


600 


19200 
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SET XL 

(XL) 

Sets the communication-port handler for PDP-11 processors. 

SET XL condition 

LINE=n 

(Valid with multiterminal support only) Uses n as the multiterminal serial port for 
XL. The value of n can be between and 16; the default is 1. 

CSR=n 

Uses n as the CSR address for the XL handler. 

[NO]MTTY 

(Valid with multiterminal support only) MTTY selects use of multiterminal as the 
interface to the XL handler. NOMTTY selects use of a DL interface for which it 
was built as the interface to the XL handler. 

VECTOR=n 

Uses n as the vector address for the XL handler. 
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SETUP 

(SETUP) 

Sets hardware characteristics for the terminal, printer, and system clock. 

SETUP [hardware] mode[,mode...] 

Table 3-2: Summary of SETUP Modes 



Mode 


Type 


Description 


132COLUMNS 


Terminal 


Displays 132 characters across screen. 


80COLUMNS 


Terminal 


Displays 80 characters across screen. 


12H0UR 


Clock 


Puts the system clock into 12-hour 
mode (Professional only). 


24HOUR 


Clock 


Puts the system clock into 24-hour 
mode (Professional only). 


480INTERLACE 


Terminal 


Sets the PRO380 to 480 INTERLACE 
mode (Professional 380 only). 


ANSWERBACK:/text/ 


Terminal 


Places text into the ANSWERBACK 
buffer (Professional only). 


[NOJBCD 


Clock 


Converts the system clock to BCD 
[binary] mode (Professional only). 


BLOCK 


Terminal 


Displays the cursor as a block, the 
default (Professional only). 


[NOJBOLD 


Terminal/Printer 


Enables [disables] bold printing. 
NOBOLD is the default. 


CAPS 


Terminal 


Causes |lock| to function as a VTIOO 
key (Professional only). This is the 
default. 


CLEAR 


Terminal/Printer 


Clears the screen and performs a soft 
reset. 


[NOJCLICK 


Terminal 


Causes keys to [not] click when 
pressed (Professional only). CLICK is 
the default. 


CLOCK SHOW 


Clock 


Displays the current clock settings 



(Professional only). 
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SETUP 



Table 3-2 (Cont.): Summary of SETUP Modes 



Mode 



Type 



Description 



COLOR 



COLORl ON C0L0R2 



Terminal 



Terminal 



[NO]COMPOSE 


National 




Replacement 


[NOJCURSOR 


Terminal 


DARK 


Terminal 


DATA 


National 




Replacement 


DATE:dd:mmm:yy 


Clock 


DEFAULTS 


Control 


DENSE 


Terminal/Printer 


DOWN 


Terminal/Printer 


DRAFT 


Printer 


[NOJDST 


Clock 


GENERIC 100 


Terminal 


GRAPHIC 


Terminal/Printer 


HELP 


Control 


HORIZONTAL^ 


Terminal/Printer 


[NOJINTERLACE 


Terminal 



Informs the software that terminal is 
a color terminal (Professional color 
terminals only). 

Sets the text to colorl and background 
to color2; colors are black, blue, cyan, 
green, magenta, red, white, and yellow 
(Professional color terminals only). 

Enables [disables] compose character 
key (Professional only). 

Causes the cursor to be [injvisible 
(Professional only). 

Displays light characters on a dark 
background. 

Sets NRC language for data processing 
characters (Professional only). 

Sets the system date as specified. 

Returns the terminal to its factory 
settings (Professional terminal only). 

Overlaps two sets of dots for a 
close approximation of letter-quality 
printing. 

Moves the print down 1/2 inch for 
alignment. 

Sets print to an 8-x-9 dot matrix. 

Puts the system clock into 
[nonjdaylight savings time mode 
(Professional only). 

Sets the reply to a device ID query as 
a generic VTIOO. 

Enters GRAPHIC mode. 

Lists brief descriptions of the SETUP 
commands. 

Prints n characters for each inch. 

Enters [exits] INTERLACE mode. 
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SETUP 



Table 3-2 (Cont.): Summary of SETUP Modes 



Mode 



Type 



Description 



JUMP 



LANDSCAPE 



Terminal 



Printer 



LANG:xxx 


Terminal/Printer 


LETTER 


Terminal/Printer 


LIGHT 


Terminal 


LISTING 


Terminal/Printer 


[NOIMARGINBELL 


Terminal 


MEMO 


Terminal/Printer 


MONO 


Terminal 


[NOINEWLINE 


Terminal 


NORMAL 


Terminal/Printer 


PAGELENGTH:n 


Terminal/Printer 


PORTRAIT 


Printer 


[NOJREPEAT 


Terminal 


RESET 


Control 


[NONIREVERSE 


Terminal 



Scrolls lines across screen as fast as 
received. 

Sets printer for wider page dimension 
(LN03 laser printers only). 

Enables the font and for the specified 
country code (Professional only). 

Enables enhanced density and 10 
characters per inch. 

Enables the display of dark characters 
on a light background. 

Enables normal density and 16.5 
characters per inch. 

Enables [disables] bell 8 columns from 
right margin (Professional only). 

Enables memo quality printing. 

Informs software that the terminal is a 
black and white terminal (Professional 
only). 

Enables [disables] generation of jlf] 
when |RET| is typed. 

Turns off terminal and printer 
character attributes, such as 
REVERSE, UNDERLINE, and BOLD. 

Prints n lines per page. 

Sets the printer for narrow page 
dimension (LN03 laser printers only). 

Enables [non]repetition of characters 
when the key is held down 
(Professional terminal only). 

Resets the terminal to previously 
saved characteristics. 

Places terminal characters in reverse 
[normal] video mode. 
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SETUP 



Table 3-2 (Cont.): Summary of SETUP Modes 



Mode 



Type 



Description 



RETAIN 


Control 


SAVE 


Control 


SETCOLOR color 


Terminal 


[red:value,blue:value, 




green:value] 




SETCOLOR color 


Terminal 


FACTORY 




SHIFT 


Terminal 



SHOW 

SMOOTH 

[NO]TABS[:n:n:n] 
TEXT 

TIME:hh:mm:ss 
TYPE 

[NOIUNDERLINE 

UNDERSCORE 

UP 

VERTICALin 
VTIOO 

[NOIWRAP 



Control 

Terminal 

Terminal/Printer 

Terminal/Printer 

Clock 

National 
Replacement 

Terminal/Printer 

Terminal 

Terminal/Printer 

Terminal/Printer 
Terminal 

Terminal/Printer 



Splits off unused NRC languages and 
retains selected language (Professional 
terminal only). 

Saves terminal characteristics. 

Customizes text and background 
colors (Professional 350 and 380 only). 

Sets the specified color to the 
distributed setting (Professional only). 

Causes |lock| to function as a 
typewriter key (Professional only). 

Shows current settings. 
(Professional only) 

Scrolls smoothly and slowly up the 
screen. 

Sets [clears] tabs at specified columns. 

Exits GRAPHIC mode. 

Sets the system time as specified. 

Sets NRC language for typewriter 
characters (Professional only). 

Enables [disables] use of underlined 
printing. 

Displays the cursor as an underscore 
(Professional only). 

Moves the print up 1/2 inch for 
alignment. 

Prints n lines per inch. 

Sets terminal into VTIOO specific 
mode. 

Enables [disables] wrapping around to 
the following line. 
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SHOW 

(RESORC) 

Lists on the console terminal information about the monitor configuration and the 
available hardware. 

SHOW option 
Command Options 



ALL 
COMMANDS 

/OUTPUT:filespec 

/PRINTER 
L /TERMINAL 

CONFIGURATION 

DEVICES[:dd] 

ERRORS 
/ALL 

/FILE:filespec 

/FROM[:date] 

/OUTPUT:filespec 

/PRINTER 

/SUMMARY 

/TERMINAL 

/TO[:date] 



JOBS 

MEMORY 

QUEUE 

SUBSET 

TERMINALS 

UMR 



ALL 



Is a combination of the CONFIGURATION, DEVICES, device assignments (SHOW 
with no option), JOBS, TERMINALS, MEMORY, and SUBSET options in that 
order. 
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SHOW 



COMMANDS 

Lists the contents of the UCL data file on the terminal. 



.SHOW COMMANDS 



ALL 
FILES 
V 
VM 



User Command Linkage (UCL) 

== SHOW ALL\TIME\DATE\\ 

== DIRECTORY/VOLUME/COLUMNS:! * .TXT 

== VBGEXE 

== $@VM\BOOT VM: \ \ 



COMMANDS/OUTPUT:filespec 

Sends contents of the UCL data file to the specified file. 

COMMANDS/PRINTER 

Sends contents of the UCL data file to the printer. 

CONFIGURATION 

Lists the monitor version, parch level, monitor SET options in effect, hardware 
configuration, and special features. 

DEVICES[:dd] 

Lists the available device handlers, status, and vector addresses; with dev lists 
information about only that device. 

ERRORS 

(Valid only if you have error logging enabled) Provides information about I/O 
transfers. 

lists all errors that have occurred. 

lists the error log from a file. 

lists errors that occurred on or after the specified date. 

lists all errors that occurred before the date (specified 
in the format dd:mmm:yy). 

writes the error report to a file. 

prints the error report on the printer. 

lists I/O errors only. 

displays the error log on the console terminal. 



ERRORS/ALL 
ERRORS/FILE :filespec 
ERRORS/FROM:date 
ERRORS/TO:date 

ERRORS/OUTPUT:filespec 
ERRORS/PRINTER 
ERRORS/SUMMARY 
ERRORS/TERMINAL 
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SHOW 

JOBS 

Lists job names and numbers, assigned console, priority, state, and memory limits. 

.SHOW JOBS 

JOB NAME CONSOLE LEVEL STATE LOW HIGH IMPURE 



14 




QUEUE 
RESORC 



SUSPEND 116224 130306 115254 
RUN 000000 126110 132344 



MEMORY 

Lists the organization of physical memory, locations of jobs and device handlers, 
and the base addresses of the USR and KMON. 

The following example shows the organization of physical memory when running 
under the XM monitor: 



. SHOW MEMORY 






JP 


xt ended M 


r^rrti^VTr ^^_ 




^^^ — ^^^ jt^ 


leinoxjr ^^- 




Address 


Module 


Words 


Type 


17760000 


lOPAGE 


4096. 


PRM 


02000000 


MEMTOP 






01000000 


VM 


131072. 


SHR 


00220700 




93984. 




00206300 


SL 


2688. 


PVT 


00200200 


MU 


1568. 


PVT 


00171700 


SP 


1632. 


SHR 


00165000 


DU 


1248. 


PVT 


00160000 


MCA 


1280. 


PRM 


00000000 


KERNEL 


28672. 


PRM 


Low Memory 






Address 


Module 


Words 




157340 


DU 


144. 




117206 


RMON 


8237. 




105144 


USR 


2577. 




001000 


. .BG. . 


17458. 





HDW 



BYP 



HDW 



QUEUE 

(Valid only when QUEUE or SPOOL is running) Lists the contents of the print 
queue. 
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SHOW 

SUBSET 

Displays the subsetting of physical disks into logical disks. For example, if you 
mount a 1000-block file DU4:WRK.DSK on logical device unit LDO and assign it 
the name WRK, SHOW SUBSET displays: 

LDO is DU4 : WRK. DSK[ 1000. ] = WRK 

TERMINALS 

Lists the status of any active terminals; valid only with multiterminal support. 



.SHOW TERMINALS 
Unit Owner Type 



WIDTH TAB CRLF FORM SCOPE SPEED 






Console 


DL 


80 


No 


No 


No 


Yes 


N/A 


1 


Local 


DL 


80 


No 


No 


No 


Yes 


N/A 


10 


Local 


DH 


80 


No 


No 


No 


Yes 


9600 


11 


Local 


DH 


80 


No 


No 


No 


Yes 


9600 


12 


Remote 


DH 


80 


No 


No 


No 


Yes 


9600 



UMR 



Displays information about the UMRs (UNIBUS mapping registers) if the UB 
pseudohandler is loaded, or information about why UB is not loaded. 



SHOW UMR 






00 


1 


10 


01 


1 


11 


02 


1 


12 


03 


1 


13 


04 


1 


14 



UMR allocation 



05 
06 
07 



15 
16 
17 



2 


20 


2 


21 


2 


22 


4 


23 


4 


24 



25 
26 
27 



9 30 

9 31 

9 32 

9 33 

9 34 

9 35 

9 36 



MS 



P 
P 
P 
P 
P 
P 
P 
37 lOPAGE P 



DU 
DU 



2. UMRs in use 

2. UMRs permanently assigned 

0. UMRs dynamically assigned 

0. requests waiting for UMR allocation 

RESORC = NOSERIAL 
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SQUEEZE 

(DUP) Consolidates directory entries. Consolidates all unused blocks and directory 
entries on a volume. 

SQUEEZE device 

Command Options 

/OUTPUT:device 

/[NOIQUERY 

AVAIT 



/OUTPUT:device 

Copies the files from the input volume to the output volume specified in device. The 
following command copies all the files from DUO: to DUl: in compressed format, 
leaving DUO unchanged: 

. SQUEEZE/OUTPUT : DUl : DUO : 

/[NOJQUERY 

/QUERY [Does not] ask for confirmation before performing the SQUEEZE operation. 

/WAIT 

Waits for the volume to be mounted before executing the command. 
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SRUN 

(KMON) 

Initiates system jobs. See also FRUN, R, RUN, and VA^RUN. 

SRUN filespec 

Filespec Options 

/BUFFER:value 

/LEVEL lvalue 

/NAME :[job-number/job-name] 

/PAUSE 

/TERMINAL:value 



/BUFFER:value 

Allocates the specified number of words of memory in addition to the actual program 
size. 

/LEVEL:value 

Assigns an execution priority level to the job, where value can be 1 through 6. 

/NAME:Job-number/Job-name 

Assigns a job-number or a logical job-name to a program. 

The following commands run VTCOM as a system job and assign it the number 6. 
All further references to VTCOM must use 6, and that number/name assignment 
remains in effect until you reboot your system. 

SRUN SY: VTCOM. SAV/NAME : 6/PAUSE 
LOAD XC=6 
RESUME 6 

/PAUSE 

Prints the load address of a program and waits for the RESUME command. 

/TERMINAL lvalue 

(Requires multiterminal support) Assigns the specified terminal to the system job. 
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START 

(KMON) 

Begins execution of a program at the specified address. 

START [address] 

SUSPEND 

(KMON) 

Temporarily stops execution of the foreground or system job. 

SUSPEND [jobname] 

The following command suspends execution of the system job, QUEUE, that is 
currently running on a system having system job support: 

.SUSPEND QUEUE 

TIME 

(KMON) 

Sets or displays the time of day. 

TIME [hh:mm:ss] 

where: 

hh specifies the hour (from to 23). 

mm specifies the minutes (from to 59). 

ss specifies the seconds (from to 59). 

The following command enters the time, eleven fifteen in the morning: 

.TIME 11:15 

The next command displays the current time: 

.TIME 
11:15:01 
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TYPE 

(PIP) 

Displays the contents of one or more files on the terminal. 

TYPE filespec[s] 



Command Options 



/BEFORE [:date] 
/SINCE [:date] 
/DATE[:date] 

'^ /NEWFILES 
/COPIES:value 
/DELETE 
/INFORMATION 
/[NOILOG 
/QUERY 
/WAIT 



/BEFORE[:date] 

Displays on the terminal only the files created before the specified date. 

. TYPE/BEFORE ■.24: MAR : 91 * . MAC 

/COPIES.value 

Displays the specified copies of the file; the number can be from 2 to 32. 

. TYPE/COPIES : 3 REPORT 

/DATE[:date] 

Displays on the terminal only those files with the specified creation date. 

. TYPE /DATE ■.20: MAR : 91 DK:*. MAC 

/DELETE 

Deletes a file after it is displayed. 

/INFORMATION 

Displays informational rather than fatal messages for files not found and displays 
the contents of all others. 

/[NOJLOG 

[Does not] list names of files as they are displayed. 
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/NOLOG prevents a list of the displayed files from displaying on the terminal. 

/NEWFILES 

Displays only those files that have the current date. 

/QUERY 

Asks for confirmation before displaying a file. 

/SINCE[:date] 

Displays on the terminal only the file created on or after the specified date. The 
following command displays only those MAC files on DK created on or after April 
21, 1991: 

. TYPE/SINCE : 21 : APR -.91 *. MAC 

/WAIT 

Waits for the volume to be mounted before executing the command. 



UNLOAD 

(KMON) Removes previously loaded handlers and terminated foreground or system 
jobs from memory. 

UNLOAD I device[,device,...] 

[ jobname[,jobname,...] 

The following command releases the line printer and RL02 handlers and frees the 
area they previously held: 

. UNLOAD LP : , DL : 



UNPROTECT 

(PIP) 

Removes a file's protected status so that it can be deleted. 

UNPROTECT filespec[s] 
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UNPROTECT 



Command Options 



/BEFORE [:date] 

/SINCE [:date] 

/DATE[:date] 

/NEWFILES 
/EXCLUDE 

/INFORMATION 

/[NOILOG 

/QUERY 

/SETDATE[:date] 

/SYSTEM 

/WAIT 



/BEFORE[:date] 

Removes protection from only those files created before the specified date. The 
following command removes the protected status of all MAC files on DK created 
before March 20, 1991: 

. UNPROTECT /BEFORE : 20 :MAR : 91 *. MAC 

Files unprotected: 

DK:A.MAC 

DK: B.MAC 

DK:C.MAC 

/DATE[:date] 

Removes protection from only those files with the specified creation date. The 
following command removes the protected status of all MAC files on DK created on 
March 20, 1991: 

. UNPROTECT /DATE : 20 :MAR : 91 *. MAC 

/EXCLUDE 

Removes protection from all the files except those you specify. 
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UNPROTECT 

/INFORMATION 

Displays informational rather than fatal messages for files not found and removes 
the protection from all others. 

/[NOJLOG 

[Does not] list on the terminal the names of all the files unprotected by the 
command. 

/NEWFILES 

Removes protection from only those files having the current system date. The 
following example removes protection from the files created today: 

. UNPROTECT /NEWFILES DUl : * . BAR 
Files unprotected: 
DUl: MERGE. BAK ? Y 

/QUERY 

Asks for a confirmation before removing protection from each file. In the following 
example protection is removed only from the file DU1:AAF.MAC: 

. UNPROTECT /QUERY DUl :*.* 
Files unprotected: 
DUl: ABC. MAC ? N 
DU1:AAF.MAC ? Y 
DUl: MERGE. FOR ? N 

/SETDATE[:date] 

Assigns the specified date to all the newly unprotected files. 

The following example removes protection from files and changes their dates to the 
current system date: 

. UNPROTECT /SETDATE DUO : * . FOR 

Files unprotected: 

DUO: ABC. FOR 

DU0:AAF.FOR 

DUO: MERGE. FOR 

/SINCE[:date] 

Removes protection from only those files created on or after the specified date. The 
following command removes protection from all MAC files on DUO created on or 
after April 21, 1991: 

. UNPROTECT /SINCE :21: APR : 91 DUO:*. MAC 
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/SYSTEM 

Removes protection from system (SYS) files when you use wildcards in the file type. 
This example removes protection from all files on DUO with the file name MM, 
including SYS files: 

. UNPROTECT/SYSTEM DUO: MM. * 
Files unprotected: 
DUO: MM. MAC 
DUO: MM. OBJ 
DUO:MM.SAV 
DUO: MM. SYS 

/WAIT 

Waits for the volume to be mounted before executing the command. The following 
example removes protection from the file FILE. MAC on an RL02 disk: 

.UNPROTECT/WAIT DLO: FILE. MAC 
Mount input volume in DLO:; Continue? Y 
DLO: FILE. MAC? Y 
Mount system volume in DLO:; Continue? Y 



V/VRUN 

Runs a program as a completely virtual job. See also FRUN, R, RUN, and SRUN. 

V program 

or 

VRUN program 

The default device for V is SY, while the default device for VRUN is DK. In the 
following example, since V is a DCL command, RT-11 returns you to the keyboard 
monitor dot prompt when it finishes execution: 

. V MACRO MYPROG MYPROG 
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Chapter 4 

RT-11 Utilities 



RT-ll utilities use the Command String Interpreter (CSI) to process the command 
lines typed to them. 



CSI Command String Format 

output-filespecs/options^input-filespecs/options 

Syntax 

output-filespec (up to three files) 

dev:filnam.typ[n],...dev:filnam.typ[n] 
input-filespec (up to six files) 

dev:filnam.typ,...dev:filnam.typ 
/option 

/x:oval or /x:dval. 



Mnemonic l\/leaning 



dev: 1- to 3-character device name 

filnam 1- to 6-character file name 

typ 0- to 3-character file type 

[n] length of output file; brackets are part of syntax 

/x option character 

oval optional octal argument or Radix-50 3-character argument 

dval. optional decimal argument; indicated by decimal point 

= separates output and input filespecs 

Some utility programs, such as BINCOM, have particular meanings assigned to 
particular files in the CSI command string. In these cases, the syntax of the 
utility's command line is shown in detail. 
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See the RT-11 System Utilities Manual (Part I and Part II) for descriptions of 
BATCH, CONFIG, CONSOL, DATIME, EDIT, NITEST, RTMON, SPLIT, and 
VBGEXE. These utilities are not summarized in this manual. 



BINCOM (Binary Compare Program) 

.R BINCOM 

*[listfile][,SIPPfile]=oldfile,newfile[/options] 

/B Compares bytes instead of words 

/D Compares two entire volumes 

/E:n Ends comparison at block n 

fa Displays help information on terminal 

/O Creates a differences listing file or SIPP command file even if no differences 

between the input files are found 

/Q Suppresses terminal output of differences 

/S:n Starts comparison at block n 
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BUP (Backup Utility Program) 

/E/X Restores .SYS files to SY when using wildcards 

/F/X Restores an entire saveset to one file 

/G Inhibits the bad-block scan on disk output volumes 

/I Backs up an entire volume to smaller volumes in image mode. Also 

used with /X during restore operations 

/L Displays a directory of a backup volume. /L/R displays a directory 

of a logical-disk file 

/M Inhibits rewinding magtape before appending next saveset to that 

magtape 

/R Creates logical-disk images of the files you want to back up. /R/X 

restores files from a logical disk 

/S Indicates the saveset containing a file you want to restore or the 

saveset from which you want to obtain directories 

A'^ verifies that input and output files match in a backup operation; 

A^/X verifies a restore operation; and A'^iONL/X verifies data in a 
previous backup operation (without restoring the data) 

AV Suppresses various informational messages 

/X Restores information backed up using BUP 

/Y Inhibits prompting for responses otherwise required from the 

terminal 

/Z Initializes a volume for use as an output volume in a backup 

operation 

no option Backs up files 
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DIR (Directory Listing Program) 

/A Lists directory alphabetically 

/B Includes starting block numbers in directory listing 

/C:n Lists directory in n columns; n can be 1 to 9 

/D[:date] Includes only files with date 

/E Lists entire directory, including unused spaces 

/F Lists short format directory in five columns 

/G Lists directory entry of specified file and all subsequent directory 
entries 

/J[:date] Lists files created on or after date 

/K[:date] Lists files created before date 

IL Lists volume directory in order of entry 

/M Lists unused areas 

/N Lists directory summary 

/O Gives sizes and block numbers in octal 

/P Lists all files except those you specify 

/Q Lists deleted files 

/R Sorts directory in reverse order; use with IS 

/S[:xxx] Sorts directory listing; xxx can be DAT, NAM, POS, SIZ, or TYP 

/T Lists only protected files 

/U Lists only unprotected files 

A^[:ONL] Includes volume ID and owner name as part of directory listing; with 
ONL, lists only ID and name 
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DUMP (File Dump Program) 

/A Displays the ASCII equivalent of each octal word or byte 

/B Outputs octal bytes 

/E:n Ends output at block n 

/G Ignores input errors 

/N Suppresses ASCII output 

/0:n Outputs only block n 

/S:n Starts output at block n 

AT Defines a magtape as non-RT-11 file structured 

AV Outputs octal words 

/X Outputs Radix-50 characters 
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DUP (Device Utility Program) 

/B[:RET] Writes FILE.BAD entries over bad blocks; use with /Z; with RET, 
retains FILE.BAD entries created by previous initialization 

/C Creates a file; use with /G:n 

/D Restores previously initialized volume 

/E:n Specifies last block number; use with /I or /K 

/F Prints names of files with bad blocks; use with /K 

/G:n Specifies starting block number; use with /C, /I, or /K 

/H Verifies after copying; use with /I 

/I Copies image of one volume to another 

/J Ignores a bad block on the input or output device and proceeds with 

the copy operation while displaying an error message. 

/K Scans a volume for bad blocks 

/N:n Defines number of directory segments; use with /Z; n can be 1 to 

37(octal) 

/O Boots a volume or file 

/Q Boots a volume that is not RT V4 or later; use with /O 

/R[:RET] Scans volume for bad blocks and creates a block replacement table; 
with RET, retains previous table 

/S Consolidates free space on a volume 

Ar:n Extends a file by n blocks; n free blocks must follow the file 

/U[:dev] Writes bootstrap into blocks 0, 2 through 5 of a volume; dev is the 

target device name 

A^[:ONL] Prints user ID and owner name; use with /Z to write new directory, 
ID, and name on volume; with ONL, writes only a new ID and owner 
name 

AV Waits for volume to be mounted before executing the command 

/X Prevents automatic reboot after using /S on system device 

/Y Suppresses query messages 

/Z[:n] Initializes device directory; n is the number of extra words in each 

directory entry 
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ERROUT (Error Log Report Writer) 

/A Displays report on each error and a summary report on all errors 

and I/O transfers 

/F:date Displays report of all errors that occurred on or after the date you 

specify 

/S Prints summary report only 

/T:date Displays report of all errors that occurred before the date you specify 
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FILEX (File Exchange Program) 

/A Transfers ASCII files character-by-character deleting nulls and 

rubouts; | ctrl/z | is interpreted as EOF 

/D Deletes a file; valid for DOS/BATCH, RSTS DECtape, interchange 

diskette 

/F Lists short directory 

/I Transfers in image mode 

/L Lists full directory 

/P Transfers in packed image mode 

/S Indicates volume is DOS/BATCH or RSTS format 

AT Indicates volume is DECsystem-10 DECtape 

/U[:n] Indicates volume is interchange diskette; n defines size of output 

record; default n is 80 

A^[:ONL] Writes a volume identification on interchange diskette; use with /U/Z; 
with ONL, writes only volume ID and keeps old directory 

AV Waits for volume to be mounted before executing the command 

/Y Suppresses query messages 

/Z Initializes device directory; vahd for DOS/BATCH, RSTS DECtape, 

interchange diskette 
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FORMAT (Volume Formatting Program) 

FORMAT can format RX02 and RX33 diskettes, and RK05, RK06, RK07, RD50, 
RD51, RD52, and RD53 disks. FORMAT can FORMATA^ERIFY:ONLY RX50, RLOl 
and RL02. RD5n disks can be formatted to run under DW: handler only. 

/P[:n] Defines patterns to be used during verification pass, n pattern n 

pattern 

1 000000 100 021042 

2 mill 200104210 
4 163126 400 155555 

10 125252 1000 145454 
20 052525 2000 146314 
40 007417 

/S Formats diskettes in single-density format 

A'^LiONL] Formats, then verifies volume; with ONL, verifies without 

formatting 

AV Waits for volume to be mounted before executing the command 

/Y Suppresses query messages 

no option Formats without verification, assumes diskettes are double-density 
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IND (Indirect Command File Processor) 

Options 

/D Deletes control file after processing 

/N Suppresses execution of KMON commands within a control file 

AT Lists each IND command line as it is executed 

/Q Suppresses display of keyboard commands and responses 

Directives 

Label Definition Directive 



.label: 



Assigns the name represented by label 
to a line in the control file so that the 
line can be referenced. 



Symbol Definition Directives 



.ASK [def:time] symbol prompt 



.ASKN [low:high:def:time] symbol 
prompt 

.ASKS [low:high:"def':time] symbol 
prompt 

.DUMP symboltable 

.ERASE LOCAL [symbolname] 
.ERASE GLOBAL [symbolname] 

.PARSE str "ctr-str" syl sy2 ....syn 

.SETD numer symbol 
.SETO numer symbol 



Defines or redefines a logical symbol 
and assigns the symbol a logical (true 
or false) value based on a response to a 
prompt. 

Defines or redefines a numeric symbol 
and assigns it a numeric value based 
on a response to a prompt. 

Defines or redefines a string symbol 
and assigns it a string value based on a 
response to a prompt. 

Displays local, global, and special 
symbol definitions. 

Deletes local or global symbol 
definitions. 

Breaks a string into substrings, which 
IND stores in string symbols. 

Redefines a numeric symbol to a 
decimal (.SETD) or octal (.SETO) radix. 
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IND (Indirect Command File Processor) 



Symbol Definition Directives 



.SETL logicalsymbol logicalexpression 

.SETN numersymbol numerexpression 

.SETS stringsymbol stringexpression 

.SETT logicalsymbol 
.SETT [mask] numersymbol 
.SETF logicalsymbol 
.SETF [mask] numersymbol 

.VOL stringsymbol device 



Defines or redefines a logical symbol 
and assigns it a logical value. 

Defines or redefines a numeric symbol 
and assigns it a numeric value. 

Defines or redefines a string symbol 
and assigns it a string value. 

Defines or redefines a logical symbol or 
redefines bits within a numeric symbol, 
and assigns the symbol or bits a true or 
false value. 

Assigns the volume identification of a 
volume to a string symbol. 



File Access Directives 



.CHAIN filespec[/options] 



.CLOSE [#n] [filespec] 
.DATA [#n] text-string 

.OPEN [#n] filespec 



.OPENA [#n] filespec 



Closes the current control file, opens 
another control file, and resumes 
execution. 

Closes an output data file. 

Specifies a single line of data to be sent 
to an output data file. 

Creates an output data file. If the file 
you specify with .OPEN already exists, 
.OPEN creates a new tentative file with 
the same name. If you subsequently 
use the .CLOSE directive, .CLOSE will 
delete the old file and make the new file 
permanent. Use the .OPEN directive 
only when you wish to write to a file. 

Opens an existing file and appends 
subsequent data to it. If the file you 
specify does not already exist, .OPENA 
creates a new file. Use this directive 
only when you wish to write to a file. 
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IND (Indirect Command File Processor) 



File Access Directives 



.OPENR [#n] filespec 



.PURGE [#n] 



.READ [#n] stringsymbol 



.STRUCTURE numsym dev 



.TESTFILE filespec 



Opens an existing file for use with the 
.READ directive. Use this directive 
only when you wish to read from a file. 

Deactivates an output file, resulting in 
no changes to already existing files. 

Reads the next record from a file into 
a string variable. The file must have 
been previously opened with .OPENR. 

Determines the file structure of a 
specified file-structured device from 
boot block information. 

Determines whether or not a file exists. 



Logical Control Directives 



.BEGIN 

.END 

.EXIT [value] 



.GOSUB label 
.GOTO label 
.ONERR label 
.RETURN 

.STOP 



Marks the beginning of a Begin-End 
block. 

Marks the end of a Begin-End block. 
Terminates processing of either a 
Begin-End block or the current control 
file and returns control to the previous 
level; can also assign a value to the 
numeric symbol <EXSTAT>. 

Branches to a subroutine within the 
control file. 

Branches to another location in the 
control file. 

Upon detecting an error, branches to 
another location in the control file. 

Returns control from a subroutine to 
the line immediately following that 
subroutine's call. 

Terminates control file processing. 
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IND (Indirect Command File Processor) 



Logical Test Directives 



.IF symbol operator expression action 



.IFDF symbol action 
.IFNDF symbol action 

.IFENABLED opmode action 
.IFDISABLED opmode action 

.IFLOA device action 
.IFNLOA device action 

.IFT logicalsymbol action 

.IFT [mask] numersymbol action 

.IFF logicalsymbol action 

.IFF [mask] numersymbol action 

.TESTDEVICE devicename[:] 

.TEST symbol 

.TEST stringsymbol matchstring 



Determines whether or not a symbol 
satisfies one of several possible 
conditions. 

Determines whether or not a symbol is 
defined. 

Determines whether an operating mode 
is enabled or disabled. 

Determines whether or not a device 
handler has been loaded. 

Determines whether a logical symbol is 
true or false, or tests specific bits in a 
numeric symbol. 

Returns information about a device in 
the string <EXSTRI>. 

Tests a symbol or string. 



Execution Control Directive 



.DELAY time 



Delays control file processing for a 
specified period of time. 



Operating Mode Directives 



.DISABLE model[,mode2,mode3...] 
.ENABLE model[,mode2,mode3...] 



Disables or enables the operating 
modes, which are: 



DATA 


LOWERCASE 


SUBSTITUTION 


DCL 


MCR 


SUFFIX 


DELETE 


OCTAL 


TIMEOUT 


ESCAPE 


PREFIX 


TRACE 


GLOBAL 


QUIET 
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Increment/Decrement Numeric Symbols Directives 



.DEC numersymbol 
.INC numersymbol 



Subtracts 1 from the value of a numeric 
symbol. 

Adds 1 to the value of a numeric 
symbol. 



KED (Keypad Editor) 



.KED 

*[ [out-filespec] [,jou-filespec]= ] in-filespec [Jou-filespec] [,init-filespec] 



DCL 



CSI 



Description 



/ALLOCATE:size 

/COMMAND [:init-filespec] 

/NOCOMMAND 

/CREATE 
/INSPECT 

/JOURNAL[:outjou-filespec] 
/NOQUERY 

/RECOVER[:injou-filespec] 



/A:n 


Allocates n blocks for 




output file 


None. Indicated by 


Executes initialization 


position in command 


file 


line 




/N 


Does not execute 




initialization file 


/C 


Creates a new file 


11 


Inspects input file, does 




not allow changes 


None. Indicated by 


Produces a journal file 


position in command 




line 




/Y 


Executes your command 




without waiting for 




confirmation 


None. Indicated by 


Recovers a text file 


position in command 




line 
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LD.SYS (Logical-Disk Handler and Utility) 

LD.SYS operates in two ways: either it can be used by programs as a handler 
to access logical disks, or it can be run as a program to initialize logical-disk 
parameters. 

/A:ddd Assigns logical name ddd to a logical-disk unit; use with /L:n 

/C Verifies all logical-disk assignments; must be alone on command line 

/L:n Assigns or deassigns logical-disk unit n 

/R:n Write locks logical-disk unit n 

AV:n Write enables logical-disk unit n 
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LET (LET Substitution Utility) 
Options 



Command /Option Function 



LET /HELP Displays help summary 

LET /LIST Displays current character assignments 

LET x/DELETE Deletes the assignment for x 

LET /DELETE Deletes all assignments with the query Are you sure? 

LET /DEL:ALL Deletes all assignments without requesting confirmation 

To enable LET, enter the command SET SL LET,KMON. This command assumes that 
SL is neither loaded nor on. 



To define a substitution: 
LET _x=string 

where 

_ tells SL that you are defining a symbol. This prevents SL from trying 

to substitute a string for the character that follows. 

X is a 1-character symbol that you want to equate with a string. 

string is a character string. 

For example, LET _#=DX;MYPROG.MAC. The following LET substitution defines the F7 
function key as the string MACRO/ LIST /CROSSREFERENCE: 

.LET F7=MACRO/LIST/CROSSREFERENCE JRfTf 
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LIBR (Librarian) 

.R LIBR 

*[libraryfile][,listfile]=inputfiles[/options] 

/A Includes in library directory all global symbols including absolute 

global symbols 

/C Allows multiple input lines 

/D Deletes a module from a library file 

/E Extracts a module from a library and stores it as a .OBJ file 

/G Deletes a global symbol from a library directory 

/M:n Creates a macro library from an ASCII input file and allocates n blocks 

for the macro name directory 

/N Includes module names in library directory 

/P Includes psect names in library directory 

/R Replaces modules in a library file 

/U Updates (inserts and replaces) modules in a library file 

AV Produces a wide (132 column) library directory listing 

/X Creates a library with multiple global definitions 

// Allows multiple input lines until next occurrence of// 

no Assumes module insertion 

option 
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LINK (Linker) 

.R LINK 
*[binfile][,mapfile][,stbfile]=objfiles[/options] 

/A Lists global symbols in alphabetical order 

/B:n Sets bottom address of program to n; invalid with /H and /R 

/C Continues input on new line; do not use with // 

/D Allows duplicate library subroutines 

/E:n:s Extends program section in root segment to specific value 

/F Uses default FORTRAN library FORLIB.OBJ when linking 

/G Increases size of linker's library directory buffer 

/H:n[:t] Specifies highest address to be used by relocatable code in optional 

type DAS or IAS space; invalid with /B, /Q, /R, /Y 

fl Extracts specified global symbols from a library 

/J Generates an extended SAV image file which separates I- and D-space 

/K:n Inserts value of « into word 56 of block as virtual .SETTOP high 

limit; n can be 1 to 32(decimal); valid only with A'^ 

/L Produces output file in LDA format; invalid with /R, A^^ 

/M[:n] Defines stack address 

/N Produces global cross-reference listing as part of load map 

/0:n Defines overlay structure; invalid with /L 

/P:n Changes amount of space linker uses for library routines list; default 

is 170 

/Q Specifies start addresses of up to eight root program sections; invalid 

with /R, /H 

/R[:n] Produces output in .REL format; n is the stack size; invalid with /B, 

/H, IK, II., Q 

/S Allows maximum memory space for linker symbol table 

/T[:n] Defines transfer address 

/U:n[:t] Rounds up program-section size in root in optional type DAS or IAS 

space; n must be a power of 2 

A^ Enables special XM monitor .SETTOP and .LIMIT features; invahd 

with /L 
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LINK (Linker) 

A^:na[nb] Specifies an extended-memory overlay segment be mapped to virtual 
region na in optional partition nb 

fW Produces a wide load map listing (132 columns) 

/X Does not output bitmap if code is below 400 

/Y[:n[:t]] Starts a program section in the root on address boundary n in optional 
type DAS or IAS space; invalid with /H 

/Z:n[:t] Sets unused locations to n in optional type DAS or IAS space 

// Allows multiple input lines; use on first and last lines of input 
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MACRO (Macro Assembler) 



.R MACRO 

* [obj file] [ ,listfile] [,creffile] =inputfiles [/options] 

Temporary files for MACRO and CREF are normally assigned to DK. Assign the 
logical name WF to reassign MACRO'S work file; assign the logical name CF to 
reassign CREF's temporary file. 

/C[:arg] Generates cross-reference table; arg can be 

C - Control and program sections 

E - Errors 

M - Macro names 

P - Permanent symbols 

R - Registers 

S - User-defined symbols 

no argument - equivalent to /C:E:M:S 

/D:arg Specifies .DSABL directives; arg can be 

ABS - Produces absolute binary output 

AHA - Assembles all relative addresses as absolute addresses 

CDR - Treats source columns beyond column 12 as comments 

DBG - Outputs ISD records as part of . OBJ file 

FPT - Floating-point truncation 

GBL - Treats undefined symbols as globals 

LC - Accepts lowercase ASCII Input 

LSB - Local symbol block 

MCL - Automatic .MCALL 

PNC - Binary output 

REG - Defines default register mnemonics 

/E:arg Specifies .ENABL directives; see values for arg under /D 
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MACRO (Macro Assembler) 

/L:arg Enables listing directives; arg can be 

BEX - Binary expansions of ASCII text 

BIN - Generated binary code 

CND - Unsatisfied conditionals and all (.IF and .ENDC 

statements) 
COM - Comments 

LD - Listing directives having no arguments 
LOC - Location counter 

MC - Macro calls and repeat range expansions 
MD - Macro definitions and repeat range expansions 
ME - Macro expansions 
MEB - Macro expansion binary code 
SEQ - Line numbers 
SRC - Source code 
SYM - Symbol table 
TOC - Table of contents 
TTM - Listing output format in 80-column format; 

default is 132-column format 

/M Macro library input file 

/N:arg Disables listing directives; refer to values for arg under /L 

/P:n Specifies pass 1 or pass 2 assembly of input source file 
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ODT/VDT (Octal Debugger) 

Commands 

[ret] Closes open location and accepts next command 

g Closes current location and opens next sequential location 

^ Opens previous location 

Indexes contents of opened location by PC and opens resulting location 

> Uses contents of opened location as relative branch and opens that 

location 

< Returns to sequence prior to @, >, or _ and opens next location 

@ Uses contents of opened location as absolute address and opens that 

location 

r/ Opens word at location r 

I Reopens last opened location 

r\ Opens byte at location r 

\ Reopens last opened location as byte 

I Displays address of opened location relative to the closest relocation 

register 

nl Displays address of opened location relative to relocation register n 

$n/ Opens general register n 

$B/ Opens first word of breakpoint table 

$C/ Opens constant register 

$F/ Opens format register 

$M/ Opens first mask register 

$P/ Opens priority register 

$R/ Opens first relocation register 

$S/ Opens status register 

r;nA Displays n bytes of ASCII starting at location r, then allows n bytes of 

input from the terminal 

;B Removes all breakpoints 

r;B Sets next free breakpoint at location r 

r;nB Sets breakpoint n at location r 

;nB Removes breakpoint n 
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ODT/VDT (Octal Debugger) 

n;C Stores n in constant register 

r;E Searches for instructions that reference effective address r 

;F Fills memory with the contents of the constant register 

r;G Starts execution of program at location r 

;I Fills memory bytes with low 8 bits of the constant register 

r;0 Calculates offset from current location to location r 

;P Execution proceeds from breakpoint 

n;P Execution proceeds from breakpoint; stops after encountering the 

breakpoint n times 

;R Sets all relocation registers to 111111 

;nR Sets relocation register n to 111111 

m;nR Sets relocation register n to value m; default « is 

R Subtracts contents of closest relocation register less than or equal to the 

contents of the current location from the contents of the location, and 
displays result 

nR Subtracts contents of relocation register n from contents of current 

location and prints result 

! Calculates address of the current location relative to the closest relocation 

register less than or equal to the address of the current location, and 
displays result 

n! Calculates address of the current location relative to relocation register 

n, and displays result 

;S Disables single-step mode 

;nS Enables single-step mode; n can be any integer 

n;W Searches for words matching value n 

X Displays contents of opened location as Radix-50; accepts three Radix-50 

characters as input 
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PAT (Object Module Patch Program) 

/C[:n] Calculates [or verifies] module checksum 



PIP (Peripheral Interchange Program) 

/A Copies files in ASCII mode 

/B Copies files in formatted binary mode 

/C[:date] Includes only files with date 

/D Deletes files 

/E Waits for volume to be mounted before executing the command 

/F Marks output files as protected 

/G Ignores any input errors 

/H Verifies output file; do not use with /A or /B 

/I[:date] Copies only files created on or after date 

/J[:date] Copies files created before date 

/K:n Transfers n copies of the output files to a sequential device, such as 

LP:, PC:, or TT: 

/M:n Controls positioning and rewinding of magtape; See the next section 

/N Does not copy or rename a file if a file of the same name exists on 

the output device 

/O Deletes a file on the output device before copying, if a file of a given 

name already exists 

/P Copies or deletes all files except those specified 

/Q Queries before performing operation 

/R Renames input filename to output filename 

/S Copies files one block at a time 

Ar[:date] Puts date on all files copied or renamed 

/U Copies and concatenates specified files 

A'^ Copies files from one large volume to several small volumes 

AV Logs operations on console 

/X Displays informational rather than fatal messages for files not 

found, and processes all others 
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PIP (Peripheral Interchange Program) 

/Y Includes .SYS files in operation 

/Z Removes protection from output files 

no option Copies files in Image mode 

Options /D, /F, /K, N, 10, /R, AT, /Z are invalid or restricted with magtape. 
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PIP— Use of /M:n 

Effect when reading from magtapes 

n = The magtape rewinds and PIP searches for the file. If more than 

one name is given, PIP rewinds for each file. If a wildcard is used, 
PIP rewinds once and then copies all matching files as they are 
encountered. 

n = +n PIP goes to file with sequence number n. If the file at that position 

matches specified name, the file is copied; otherwise PIP returns file 
not found error. If a wildcard is used, PIP begins the search at file 
n. 

n = -1 PIP begins the search at current position without rewinding. 

Effect when writing to magtapes 

n - The tape rewinds before each file is copied and PIP searches for a 

duplicate file name. If a file of the same name is found, PIP prints 
a warning and does not copy the file. Otherwise, the file is written 
at LEOT. 

n = +n PIP goes to file sequence number n and enters specified file. If 

LEOT is encountered before file n, an error is printed. If more than 
one file name is specified or a wildcard is used, the tape does not 
rewind and PIP does not check for duplicate names. 

n = -1 PIP goes to LEOT and enters specified file without checking for 

duplicate names. 

n = -2 The tape rewinds before each copy operation. PIP enters the file at 

LEOT or at the occurrence of a duplicate file name. 
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QUEMAN (Queue Manager) 

/A Halts QUEUE 

/C[:date] Prints only files created on date 

/D Deletes files after printing 

/H:n Prints n banner pages 

/I[:date] Prints only files created on or after date 

/J[:date] Prints files created before date 

/K:n Prints n copies of a file 

/L Lists current contents of the queue 

/M Deletes a file from the queue 

/P Sets QUEUE defaults for /H and deletion of work file 

/Q Asks for confirmation before printing 

/R Resumes or restarts current job 

/S Suspends current job; resume with /R 

AV Logs all files printed 

/X Prints error messages for files not found and processes all others 

// Allows multiple input command lines 
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RESORC (Resource Program) 

/A Combines all options except /Z 

/C Identifies system device and lists monitor SET options in effect 

[dd:]/D Lists available device handlers and their vectors; with dd:, lists 

information about only that device 

/H Lists system hardware configuration 

/J Lists currently loaded jobs 

/L Lists device assignments 

/M Lists monitor type, version number, and patch level 

/O Lists special features included by SYSGEN 

/Q Lists contents of SPOOL and/or QUEUE queue 

/S Lists disk subsetting in effect 

/T Lists status and options in effect for active terminals on a multiterminal 

system 

A^ Lists release and version numbers for RT-11 image modules 

/X Lists organization of physical memory 

/Z Combines /C, /H, /J, /M, /O 
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SIPP (Save Image Patch Program) 

.R SIPP 
*[commandfile]=inputfile[/options] 

Options 

/A Prevents automatic update of location 50, window definition block, 

overlay handler, or overlay tables 

/C Asks for checksum at completion of the patch 

/D Prints checksum at completion of the patch 

/L Does not modify the input file 

Commands 



Closes current location, opens and displays next location 
Closes current location, opens and displays next location 

n [RET] Deposits value n in current location, closes current location, opens and 

displays next location 

/ Advances in word mode 

/ [ret] Reopens current location as a word 

\ [ret1 Reopens current location as a byte 

\ Advances in byte mode 

^ [ret] Closes current location, opens and displays previous location 

n^ lRET] Deposits value n in current location, closes current location, opens and 

displays previous location 

;A Interprets location contents as ASCII 

;0 Gives values in octal, accepts input in octal 

;Ax Deposits ASCII character x in low byte of current location, opens and 

displays high byte in octal, accepts further input in ASCII 

;R Interprets location contents as Radix-50 characters 

;Ryyy Deposits Radix-50 characters yyy in current location, closes current 

location, opens next location and gives value in octal, accepts further 
Radix-50 character input 

;S Prompts for value for which to search 

;V Prints all previously entered modifications 
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Prompts for checksum, if /C used, and installs patch 



|CTRLiz| Backs up to previous SIPP prompt 



SLP (Source Language Patch Program) 

.R 

*[patchedfile][,listfile]=inputfile[,commandfile][/options] 

Options 

/A Disables audit trail generation 

/B Uses spaces instead of tabs to position audit trail text 

/C Computes checksum for file 

/C:n Validates checksum for file 

/D Creates a double-spaced listing 

/L:n Defines maximum length of a source line, in characters 

/N Suppresses creation of backup file 

/P:n Starts audit trail in column n 

/S:n Defines length of audit trail; maximum value for n is 16(decimal) 

AT Retains trailing tabs and blanks in updated file 

Command File Operators 

Indicates start of an update 

\ Disables audit trail 

% Enables audit trail 

/ Indicates the end of an update or series of updates 

// Separates concatenated SLP command files 

< Indicates that the next character should be taken as source input, not 

interpreted as a command; use in front of _, \, %, /, and < when they must 
be inserted in a file 
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SRCCOM (Source Compare Program) 

.R SRCCOM 
*[listfile][,SLPfile]=oldfile,newfile[/options] 

/A Specifies audit trail for SLP command file 

/B Compares blank lines 

/C Ignores comments and spacing 

/D Copies newfile to listfile and inserts change bars and bullets at left margin 

of listfile to mark differences 

/F Includes formfeeds in output file 

/L:n Defines number of lines that must agree to constitute a match; n can be 1 

to 310; default is 3 

/S Ignores spaces and tabs when comparing 

AT Includes trailing spaces and tabs in comparison 

A^:i:d Defines characters to use as markers for inserts and deletions in place of 
change bars and bullets; use with /D; i and d are the numeric values for 
the ASCII characters to use. 
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TRANSF (RT-11 Native Transfer Utility) 

TRANSFoutfile[/options]=infile[/options] 

where: 

outfile specifies the file to which you want a file copied, 

infile specifies the file you want to copy, 

options specifies the options. 



Options 

/S Enables log messages and rings terminal bell as files are transferred. 

AT Specifies which file is the RT-11 stand-alone system file. 

AV Displays log messages during file transfers, but does not ring 

terminal bell. 
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TRANSFER (RSX/VMS Native Transfer Utility) 

TRANSFER infile/qualifier[s] [outfile/qualifier[s]] 

where: 

infile specifies the file you want to copy 

outfile specifies the file to which you want to transfer the input file 

/qualifier specifies a TRANSFER qualifier 



Command 
Qualifiers 



File Qualifiers 
(input or output) 



/HELP 

/PROMPT 

/VERSION 



/ASCII[:n] 
/BINARY[:n] 
/FORTRAN[:n] 
/IMAGE [:n] 

/LOG 

/PROGRESS[:n] 
f /REMOTE 1 
t /TERMINAL 1 

/STATISTICS 



{} 



specifies mutually exclusive qualifiers. 
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TRANSFER (RSX/VMS Native Transfer Utility) 



Qualifier 



Type 



Function 



/ASCII[:n] 


mode 


/BINARY[:n] 


mode 


/FORTRAN[:n] 


mode 


/HELP 


control 


/IMAGE [:n] 


mode 


/LOG 


control 


/PROGRESS[:n] 


control 


/PROMPT 


control 


/REMOTE 


control 


/TERMINAL 


control 


/SPOOL 


control 


/STATISTICS 


control 


AVERSION 


control 



formats the output as ASCII. 

formats the output as a binary OBJ file. 

transfers files containing FORTRAN 
carriage-control characters. 

displays information about TRANSFER. 

transfers files without performing any 
record translations on them. 

creates a log of the names of all the files 
transferred. 

displays the progress of the transfer at 
specific intervals while the operation is 
taking place. 

operates in an interactive mode that 
displays questions, indicates defaults, and 
accepts input. 

specifies the file on the local RT-11 system. 

specifies the file on the local RT-11 system 
(this qualifier is identical to /REMOTE). 

queues the TRANSFER output file to the 
default VMS printer queue. 

displays the number of retries and the 
number of characters saved through 
compression encoding. 

displays the TRANSFER utility's version 
number. 
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VTCOM (Virtual Terminal Communications) 

VTCOM enables you to connect your stand-alone RT-11 operating system to another 
computer's operating system. 

To issue a VTCOM command, first enter terminal mode by typing |ctruf| or | ctrl/x | 
and the system-job name. Then, at the VTCOM> prompt, type | ctrl/p | . 



Commands 



Command 



Function 



BREAK 
CLEAR 

CLOSELOG 
CONTINUE 



I CTRL/P I 

DIAL 
EXIT 

FAST 

HANGUP 

HELP 

LOG 

NOLOG 

OPENLOG 



Lets VTCOM transmit CTRL characters that would normally 
be intercepted: | ctrl/b | , | ctruf | , | ctrl/o | , | ctrl/p | , | ctrlvq | , | ctrl/s | . 

Transmits a break signal to host. 

Clears any | ctrl/s | characters that have been sent, and starts 
sending characters to the terminal again. 

Stops recording input in a log file and closes the log file. 
Returns your system to terminal mode. 
Sends a | ctrl/p | character to the host, VTCOM normally 
intercepts | ctrl/p | characters and interprets them as a request 
to enter a VTCOM command. 

Causes the modem to dial the telephone dial string you 
specify. 

Terminates the VTCOM program and the XC or XL handler 
and closes any open logging file. To restart VTCOM, you must 
use the FRUN or SRUN command. 

Lets VTCOM transmit ASCII characters to the host at high 
speed during a SEND operation. 

Breaks the modem connection. 

Displays a list of VTCOM commands. 

Resumes recording data in a log file after a NOLOG command. 

Suspends the recording of data in a log file. 

Opens a log file to receive ASCII input from the host system, 
and starts recording input in the log file. 
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VTCOM (Virtual Terminal Communications) 



Command 



Function 



PAUSE 
RESET 

SELECT 
SEN D 

SHOW 



SLOW 



Ends VTCOM program control. 

Halts file transfers using TRANSF and VTCOM SEND 
operations. 

Lets you specify a port on a Mini-Exchange. 

Transfers an ASCII file from your stand-alone system to a 
host as if the file were being typed. 

Displays the following VTCOM characteristics: 
Data transfers in progress 
Logging status — on or off 
SEND status — slow or fast 
Current dial string 

Causes VTCOM to transmit ASCII characters to the host at 
slow speed during a SEND operation. 
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